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Preface 


The complete UNIX Reference is actually divided into nine parts and 
distributed as individual reference sections in the various volumes of the 
Operating, and Development Systems. The following table lists the 
name, content, and location of each reference section. 


Section 

Description 

Volume 

ADM 

Administrative Commands - used 
for system administration. 

System Administrator’s 
Reference 

C 

Commands - used with the 
Operating System. 

User’s Reference 

CP 

Programming Commands - used 
with the Development System. 

Programmer’s Reference 

DOS 

Routines - used with the 
Development System 

Programmer’s Reference 

F 

File Formats - description of 
various system files not defined in 
section M. 

User’s Reference 

HW 

Hardware device manual pages - 
information about hardware 
devices and device nodes. 

System Administrator’s 
Reference 

M 

Miscellaneous - information used 
for access to devices, system 
maintenance, and communi¬ 
cations. 

User’s Reference 

S 

System Calls and Library 
Routines - available for C and 
assembly language programming. 

Programmer’s Reference 


In the manual pages, a given command, routine, or file is referred to by 
name and section. For example, the programming command “cc”, which 
is described in the Programming Commands (CP) section, is listed as 
cc(CP). 








The alphabetized table of contents given on the following pages is a 
complete listing of all UNIX commands, system calls, library routines, 
and file formats. The permuted index, found at the end of the User's 
Reference , and the the end of the Programmer's Reference , is useful in 
matching a desired task with the manual page that describes it. Certain 
pages in the Operating System distribution make reference to include files 
that are part of the Developement System. 



Alphabetized List 

Commands, Systems Calls, Library Routines and File Formats 


300 . 300(C) 

4014 . 4014(C) 

450 . 450(C) 

80387. 80387 ( HW) 

86rel . 86rel( F) 

TZ.te(M) 

_exit . exit( S) 

a.out. a.out(¥) 

a641 . a 64l( S) 

abort . abort(S) 

abs. abs( S) 

accept . accept (ABM) 

access . access (S) 

acct . am (ADM) 

acct. acct( F) 

acct. acct(S) 

acctcms. acctcms( ADM) 

acctcom. acctcom (ADM) 

acctdisk. am (ADM) 

acctdusg. am (ADM) 

acctmerg . acctmerg (ADM) 

accton. acct (ADM) 

accton. accton (ADM) 

acctprc. acctprc (ADM) 

acctprcl. acctprc (ADM) 

acctprc2. acctprc (ADM) 

acctsh. acctsh (ADM) 

acctwtmp . acct (ADM) 

acos . trig(S) 

adb. adb(CP) 

adfmt. adfmt( ADM) 

admin. admin (CP) 

alarm . alarm( S) 

ar. ar(CP) 

ar. ar( F) 

archive . archive( F) 

ascii. ascii (M) 

asctime . ctime( S) 

asin. trig( S) 

asktime. asktime (ABM) 

assert. assert( S) 


assign . assign(C) 

asx. asx(CP) 

at. at(C) 

atan . trig( S) 

atan2. trig( S) 

atcronsh. atcronsh(ADM) 

atof. atof( S) 

atof. strtod( S) 

atoi. atof(S) 

atoi. strtol (S) 

atol. atof( S) 

atoi. strtol (S) 

audit. audit( ADM) 

auditcmd . auditcmd (ADM) 

auditd. auditd(ABM) 

auditsh . auditsh(ABM) 

authcap . authcap( F) 

authck . authck (ADM) 

auths. auths(C) 

authsh. authsh( ADM) 

authsh. authtsh (ADM) 

autoboot. autoboot(ABM) 

awk. awk(C) 

backup. backup (ADM) 

backupsh. backupsh (ADM) 

badtrk. badtrk (ADM) 

banner. banner(C) 

basename . basename(C) 

batch. at( C) 

be.fcc(C) 

bcheckrc. bre (ADM) 

bdiff. bdiff(C) 

bdos. bdos(DOS) 

bessel . bessel( S) 

bfs. bfs( C) 

boot. boot(WN) 

bre . fere (ADM) 

brk. sbrk( S) 

brkctl . brkctl (S) 

bsearch. bsearch( S) 

cal . cal(C) 
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calendar . calendar (C) 

calloc . malloc( S) 

cancel . lp(C) 

captoinfo . captoinfo (ADM) 

cat . cat(C) 

cb . cb( CP) 

cc.cc(CP) 

cd. cd( C) 

cdc .cdc(CP) 

ceil. floor (S) 

cflow. cflow( CP) 

cgets. cgets( DOS) 

chargefee. acctsh (ADM) 

chdir. chdir(S) 

checklist . checklist (F) 

checkmail . checkmail (C) 

checkque . checkque (ADM) 

chg_audit .... chg_audit (ADM) 

chgrp. chgrp( C) 

chmod. chmod (C) 

chmod. chmod( S) 

chown . chown( C) 

chown. chown( S) 

chroot . chroot (ADM) 

chroot. chroot (S) 

chrtbl. chrtbl( M) 

chsize . chsize (S) 

ckpacct . acctsh ( ADM) 

cleantmp. cleantmp (ADM) 

clear . clear(C) 

clearerr . /error (S) 

clock. clock (F) 

clock. clock (S) 

close. close (S) 

clone . clone (M) 

closedir . directory (S) 

clri. clri (ADM) 

cmchk . cmchk( C) 

cmos. cmos( HW) 

cmp . cmp( C) 

col . col( C) 

coltbl. coltbl (M) 

comb. comb (CP) 

comm. comm(C) 

compress . compress (C) 

configure. configure (ADM) 


console. 

. console (M) 

consoleprint. consoleprint ( ADM) 

conv. 


convkey . 

. map key ( M) 

copy . 

. copy(C) 

core. 


cos. 

. trig (S) 

cosh . 

. sinh( S) 

q>. 

. cp(C) 

cpio. 

. cpio( C) 

cpio . 

. cpio( F) 

cpp 

. cpp{ CP) 

cprintf . 

. cprintf ( DOS) 

cputs. 

. cputs ( DOS) 

crash. 

. crash (ADM) 

creat . 

. creat ( S) 

creatsem. 

. creatsem (S) 

cref. 

.ere/(CP) 

cron. 

. cron(C) 

crontab. 

. crontab (C) 

crypt . 

. crypt(C ) 

cscanf. 

. cscanf ( DOS) 

csh . 

. csh( C) 

csplit. 

. csplit (C) 

ct . 

. ct(C) 

ctags. 

. ctags (CP) 

ctermid . 

. ctermid (S) 

ctime. 

. ctime (S) 

ctype. 

. ctype (S) 

cu. 

. cu(C) 

curses . 


curtbl. 

. curtbl (M) 

cuserid. 

. cuserid (S) 

custom. 

. custom ( ADM) 

cut. 

. cut( C) 

cvtcoff. 

. cvtcoff( M) 

cvtomf. 

. cvtomf ( M) 

cxref. 

. cxref (CP) 

daemon.mn . 

.... daemon.mn(M) 

date. 


dbmbuild. 

.. dbmbuild (ADM) 

dbminit. 

. dbm( S) 

dc. 

. dc(C) 

dcopy . 

. dcopy (ADM) 

dd. 

. dd(C) 

deassign. 

. assign(C) 
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default. default (F) 

defopen. defopen { S) 

defread . defopen (S) 

delete . dbm{ S) 

deliver . deliver (ADM) 

delta. delta {CP) 

deroff. deroff(C) 

devices. devices (F) 

devnm. devnm(C) 

df. df{ C) 

dial . dial (ADM) 

dial. dial{ S) 

dialcodes . dialcodes (F) 

dialers . dialers (F) 

difif. diff{ C) 

diffi. diff3{C) 

dir. dir{ F) 

dircmp. dircmp(C) 

directory . directory (S) 

dirent . dirent{ F) 

dirname. dirname{ C) 

disable. disable (C) 

diskcmp. diskcp(C) 

diskcp . diskcp(C) 

diskusg. diskusgi ADM) 

display. display { HW) 

displaypkg . displaypkg (ADM) 

divvy. divvy (ADM) 

dlvr_audit .. dlvr_audit { ADM) 

dmesg. dmesg{ ADM) 

dodisk . acctsh{ ADM) 

dos. dos{ C) 

doscat. dos{ C) 

doscp. dos(C) 

dosdir. dos{ C) 

dosexterr. dosexter{ DOS) 

dosformat. dos(C) 

dosld. dosld{CP) 

dosls. dos(C) 

dosmkdir. dos{ C) 

dosrm. dos(C) 

dosrmdir . dos(C) 

dparam. dparam{ ADM) 

drand48 . drand48{ S) 

dtox. dtox(C) 

dtype. dtype{ C) 


du. 

. du(C ) 

dumpdir. 

. dumpdir(C) 

dup. 


dup2. 


echo. 

. echo{C) 

ecvt. 

. ecvt{ S) 

ed. 

. ed( C) 

edata . 

. end{ S) 

edit. 

. ex(C) 

egrep . 

. grep(C) 

enable. 

. enable (C) 

end. 

. end{ S) 

endgrent. 

. getgrentiS) 

endpwent. 

. getpwent(S) 

endutent. 

. getut(S) 

env. 


environ . 

. environ { M) 

eof. 

. eof( DOS) 

erand48.. 

. drand48(S) 

erf. 

. erf( S) 

erfc . 

. erf( S) 

errno . 

. perror{ S) 

error . 


etext. 

. end( S) 

ev block . 

. ev block (S) 

ev close. 

. ev close (S) 

ev count . 

. ev count (S) 

ev flush. 

. evJlush{ S) 

ev getdev . 


ev getemask ... 

... ev gtemsk{ S) 

ev gindev . 

.... ev gindev (S) 

ev init . 

. . ev init(S) 

ev open . 


ev_pop . 


ev read . 


ev resume . 

... ev resume (S) 

ev setemask ... 

.... ev stemsk{ S) 

ev suspend. 


ex. 


execl. 

. exec (S) 

execle. 

. exec (S) 

execlp . 


execseg. 

. execseg (S) 

execv . 


execve . 


execvp . 

. exec (S) 





























































































exit .exit (DOS) 

exit . exit( S) 

exp. exp(S) 

expr. expr(C) 

fabs. floor(S) 

factor. factor(C) 

false. false(C) 

fclose. /close (DOS) 

fciose . fclose (S) 

fcloseaii. fclose (DOS) 

fcntl. fcntl( M) 

fcntl . fcntl (S) 

fcvt.ecvi(S) 

fd. fd( HW) 

fdisk. /disk (ADM) 

fdopen. fopen( S) 

fdswap . fdswap( ADM) 

feof. ferror( S) 

ferror . ferror( S) 

fetch . dbm(S) 

fflush. fclose (S) 

fgetc . fgetc (DOS) 

fgetc . getc( S) 

fgetchar./getc(DOS) 

fgets. gets( S) 

fgrep. grep(C) 

file ./i/e(C) 

filehdr. filehdr( F) 

filelength . fileleng( DOS) 

fileno. ferror (S) 

filesys .jft/e5ys(F) 

filesystem . filesystem ( F) 

find. find(C) 

finger. finger(C) 

firstkey . dbm( S) 

fixhdr . fixhdr(C) 

fixperm. fixperm( ADM) 

floor . floor( S) 

flushall. flushall (DOS) 

fmod. floor (S) 

fopen. fopen(S) 

fork. fork( S) 

format . format( C) 

fp_off.^_^g(DOS) 

fp_seg. fp_seg (DOS) 

fprintf. printf( S) 


iv 


fputc . fputc( DOS) 

fputc. putc (S) 

fputchar. fputc ( DOS) 

fputs . puts (S) 

fread. fread( S) 

free. malloc(S) 

freopen. fopen (S) 

frexp. frexp(S) 

fsave. fsave (ADM) 

fscanf. scanf( S) 

fsck. fsck( ADM) 

fsdb . fsdb(ADM) 

fseek. fseek( S) 

fsname. fsname( ADM) 

fspec . fspec( F) 

fsphoto . fsp ho to (ADM) 

fsstat . fsstat( ADM) 

fstab./j?tob(F) 

fstat. stat(S) 

fstatfs . staffs (S) 

fstyp./5/yp(ADM) 

ftell. fseek (S) 

ftime . time( S) 

ftok. stdipc( S) 

ftw.^vv(S) 

fwrite. fread (S) 

fwtmp. fwtmp(ADMi) 

fxlist. xlist( S) 

gamma. gamma(S) 

gcvt. ecvt( S) 

get. get( CP) 

getc. getc( S) 

getch .^e?c/i(DOS) 

getchar. getc( S) 

getche. getche (DOS) 

getclk. getclk( M) 

getcwd. getcwd( S) 

getdents .. getdents (S) 

getegid. getuid( S) 

getenv . getenv( S) 

geteuid. getuid(S) 

getgid. getuid( S) 

getgrent. getgrent (S) 

getgrgid . getgrent (S) 

getgrnam. getgrent (S) 

getlogin . getlogin(S) 
































































































getopt. 

getopt. 

getoptcvt .. 

getopts. 

getpass. 

getpgrp. 

getpid . 

getppid. 

getpw. 

getpwent... 
getpwnam 
getpwuid .. 

gets. 

gets . 

getty. 

gettydefs ... 

getuid . 

getut. 

getutent .... 

getutid . 

getutline ... 

getw. 

gmtime . 

goodpw . 

gps. 

graph . 

greek . 

grep. 

group. 

grpcheck .. 

gsignal. 

haltsys. 

hashcheck 
hashmake . 

hcreate . 

hd. 

hd. 

hdestroy ... 

hdr. 

head. 

hello. 

help .. 

hp. 

hsearch. 

hwconfig ... 
hypot. 


. getopt (C) 

. getopt (S) 

. getopts (C) 

. getopts (C) 

. getpass (S) 

. getpid (S) 

. getpid (S) 

. getpid (S) 

. getpw (S) 

. getpwent (S) 

. getpwent (S) 

. getpwent ( S) 

. gets(C) 

. gets(S) 

. getty (M) 

. gettydefs (F) 

. getuid (S) 

. getut (S) 

. getut (S) 

. getut{ S) 

. getut (S) 

.g^c(S) 

. ctime (S) 

goodpw (ADM) 

. gps(JF) 

... graph( ADM) 

. greek (C) 

. grep(C) 

. group(¥) 

.... grpcheck (C) 

. ssignal (S) 

. haltsys (ADM) 

. spell (C) 

. spell (C) 

. hsearch (S) 

. hd(C) 

. hd( HW) 

. hsearch( S) 

. hdr( CP) 

. head(C) 

. hello (C) 

. help (CP) 

. hp(C) 

. hsearch(S) 

.... hwconfig(C) 
. hypot( S) 


i286emul. i286emul( C) 

i386 . machid(C) 

idbuild. idbuild( ADM) 

idcheck. idcheck( ADM) 

idinstall . idinstall (ADM) 

idleout. idleout( ADM) 

idload. idload(ADM) 

idmkinit . idmkinit( ADM) 

idspace. idspace(ADM) 

idtune. idtune( ADM) 

imacct . imacct(C) 

infocmp. infocmp( ADM) 

inir . init( M) 

init. init( M) 

initcond . initcond (ADM) 

inittab . inittab( F) 

inode. inode (F) 

inp. inp (DOS) 

install . install (ADMl) 

installpkg .... installpkg (ADM) 

int86. int86( DOS) 

int86x. int86x( DOS) 

intdos. intdos( DOS) 

intdosx. intdosx( DOS) 

integrity. integrity (ADM) 

ioctl. ioctl (S) 

ipcrm . ipcrm (ADM) 

ipcs. ipcs (ADM) 

ips.z/w(ADM) 

isalnum. ctype(S) 

isalpha . ctype (S) 

isascii . ctype (S) 

isatty . isatty (DOS) 

isatty . ttyname (S) 

isbs . ips (ADM) 

iscntrl. ctype (S) 

isdigit . ctype (S) 

isgraph. ctype (S) 

islower . ctype (S) 

ismpx . ismpx(C) 

isprint . ctype (S) 

ispunct . ctype (S) 

isspace. ctype (S) 

issue. issue ( F) 

isupper. ctype (S) 

isxdigit . ctype (S) 
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itoa. itoa( DOS) 

jO . bessel (S) 

jl . bessel (S) 

jagent. jagent( M) 

jn . bessel (S) 

join . join (C) 

jrand48. drand48( S) 

jterm. jterm(C) 

jwin. jwin(C) 

kbhit . kbhit( DOS) 

kbmode . kbmode (ADM) 

keyboard . keyboard (HW) 

kill . kill (C) 

kill.M/(S) 

killall . killall (ADM) 

kmem. mem(¥) 

1 ./(C) 

13tol . l3tol( S) 

164a . a«/(S) 

labelit./afceto(ADM) 

labs. labs(DOS) 

langinfo. langinfo( F) 

last . last( C) 

lastlogin. acctsh( ADM) 

layers. layers (C) 

layers. layers (M) 

lc. lc(C) 

lcong48 . drand48( S) 

Id. ld( CP) 

Id./J(M) 

ldexp. jrexp(S) 

ldfcn. ldfcn ( ¥) 

ldfcn./#cn(F) 

lex . lex (CP) 

lfind . Isearch (S) 

limits. limits (F) 

line. line(C) 

linenum. linenum(¥) 

link . link (ADM) 

link. link( S) 

link_unix. linkjinix (ADM) 

lint. lint (CP) 

list . list (ADM) 

In. ln(C) 

locale . locale( M) 

localtime . ctime( S) 


vi 


lock . 


lock. 


lockf . 

. lockf(S) 

locking. 


log . 


log . 

. log( M) 

loglO. 

. exp( S) 

login . 

. login ( M) 

logname . 

. logname (C) 

logname. 

. logname (S) 

logs . 

. logsl F) 

longjmp . 


lorder. 

. lorder( CP) 

•p. 

. lp(C ) 

ip. 

./p(HW) 

lpO. 

./p(HW) 

Ipl. 

. lp( HW) 

Ip2. 

./p(HW) 

lpadmin . 

... lpadmin( ADM) 

lpfilter. 

. lpfdter( ADM) 

lpforms. 


lpmove. 

.... lpsched (ADM) 

lprint. 


lpsched . 

.... lpsched( ADM) 

lpsh . 

. lpsh (ADM) 

lpshut. 

.... lpsched (ADM) 

Ipstat. 

. Ipstat (C) 

lpusers. 


Irand48 . 

. drand48( S) 

Is. 

. ls(C ) 

Isearch. 

. Isearch (S) 

lseek. 

.. lseek ( S) 

Itoa. 

. Itoa (DOS) 

ItoI3 . 

. l3tol( S) 

m4. 

. m4( CP) 

machid . 

. machid (C) 

machine . 

. machine (HW) 

mail . 

. mail (C) 

majorsinuse. majorsinuse (ADM) 

make. 

. make (CP) 

makekey. 

.. makekey (ADM) 

malloc. 

. malloc (S) 

man. 


mapchan . 

. mapchan (F) 

mapchan . 

. mapchan( M) 

mapkey. 

. mapkey ( M) 

































































































mitncmi 

mnpkey (M) 

mtune. 

. mtune ( F) 

mapstr. 


multiscreen .. 

.. multiscreen (M) 

masm. 


mv . 


math . 

. math(M) 

mvdir. 

. mvdir ( ADM) 

matherr. 

. matherr (S) 

nap . 

. nap( S) 

maxuuscheds. maxuuscheds( F) 

nbwaitsem ... 

. waitsem( S) 

maxuuxqts. 

. maxuuxqts ( F) 

ncheck . 

.... ncheck (ADM) 

mdevice . 

. mdevice (F) 

netutil. 

. netutil (ADM) 

mem . 

. mem(F) 

newform. 

. newform (C) 

memccpy .... 

. memory (S) 

newgrp. 

. newgrp (C) 

memchr. 


news. 

. news( C) 

memcmp .... 

. memory (S) 

nextkey . 

. dbm( S) 

memcpy . 

. memory (S) 

nice . 

. nice (C) 

memset. 

. memory (S) 

nice. 


mesg. 

. mesg( C) 

nictable. 

... nictable (ADM) 

messages .... 

. messages (M) 

nl. 


mestbl. 

. mestbl (M) 

nlist . 

. nlist (S) 

mfsys . 

. mfsys (F) 

nlsadmin. 

. nlsadmin (ADM) 

micnet ........ 

. micnet (F) 

nl type . 

. nl type (F) 

mkdev. 


nm. 

. nm(CP) 

mkdir. 

. mkdir (C) 

nohup . 

. nohup (C) 

mkdir . 


nrand48 . 

. drand48( S) 

mkfs. 

. mkfs (ADM) 

null. 

. null( F) 

mknod. 

. mknod (C) 

nulladm . 

. acctsh (ADM) 

mknod. 

. mknod (S) 

numtbl . 

. numtbl ( M) 

mkstr . 

. mkstr (CP) 

od . 

. od( C) 

mktemp . 

. mktemp (S) 

open. 

. open( S) 

mmdf. 

. mmdf(ADM) 

opendir. 


mmdfalias . 

.. mmdfalias (ADM) 

opensem. 

. opensem( S) 

mnlist . 

. mnlist (ADM) 

outp. 
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Intro _ 

introduces UNIX commands 

Description 


This section describes use of the individual commands available in the 
UNIX Operating System. Each individual command is labeled with 
either a C, or a CP for easy reference from other volumes. The letter 
“C” stands for “command”. The letter “P” stands for commands 
that come with the optional Development System (Programming). For 
example, the reference date (C) indicates a reference to a discussion of 
the date command in the C section; the reference cc(CP) indicates a 
reference to a discussion of the cc command in the Development Sys¬ 
tem. The Development System is an optional supplemental package 
to the standard Operating System. 

The “ADM” Administration section contains miscellaneous informa¬ 
tion including a great deal of system maintenance information. Other 
reference sections include the “M” Miscellaneous section, the “S” 
System Services section, the “DOS” Routines section and the “F” 
File Format section. 

Syntax 


Unless otherwise noted, commands described in the Syntax section of 
a manual page accept options and other arguments according to the 
following syntax and should be interpreted as explained below. 

name [-option ...] [cmdarg...] 
where: 


[ ] Surround an option or cmdarg that is not required. 

Indicates multiple occurrences of the option or 
cmdarg . 


name The name of an executable file. 

option (Always preceded by a “-”.) 

noargletter ... or, 
argletter optarg[,...] 

noarg letter A single letter representing an option without an 

option-argument. Note that more than one noargletter 
option can be grouped after one “-” (Rule 5 in the 
following text). 
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argletter 

A single letter representing an option requiring an 
option-argument. 

optarg 

An option-argument (character string) satisfying a 
preceding argletter. Note that groups of optargs fol¬ 
lowing an argletter must be separated by commas or 
separated by white space and quoted (Rule 8 below). 

cmdarg 

Path name (or other command argument) not begin¬ 
ning with or by itself indicating the standard 

input. 

Command Syntax Standard: Rules 

These command syntax rules are not followed by all current com¬ 
mands, but all new commands use them, getopts (C) should be used 
by all shell procedures to parse positional parameters and to check for 
legal options. It supports Rules 3-10 below. The enforcement of the 
other rules must be done by the command itself. 

1. 

Command names ( name above) must be between two and 
nine characters long. 

2. 

Command names must include only lowercase letters and 
digits. 

3. 

Option names ( option above) must be one character long. 

4. 

All options must be preceded by 

5. 

Options with no arguments may be grouped after a single 

< i > » 

6. 

The first option-argument ( optarg above) following an 
option must be preceded by white space. 

7. 

Option-arguments cannot be optional. 

8. 

Groups of option-arguments following an option must either 
be separated by commas or separated by white space and 
quoted (e.g., -o xxx,z,yy or -o "xxx z yy"). 

9. 

All options must precede operands ( cmdarg above) on the 
command line. 

10. 

” may be used to indicate the end of the options. 

11. 

The order of the options relative to one another should not 


matter. 
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12. The relative order of the operands (cmdarg above) may 
affect their significance in ways determined by the command 
with which they appear. 

13. preceded and followed by white space should only be 
used to mean standard input. 

See Also 


getopts(C), exit(S), wait(S), getopt(S) 

Diagnostics 


Upon termination, each command returns 2 bytes of status, one sup¬ 
plied by the system and giving the cause for termination, and (in the 
case of “normal” termination) one supplied by the program (see 
wait(S) and exit(S)). The former byte is 0 for normal termination; the 
latter is customarily 0 for successful execution and nonzero to indicate 
troubles such as erroneous parameters, bad or inaccessible data. It is 
called variously “exit code”, “exit status”, or “return code”, and is 
described only where special conventions are involved. 

Notes 


Not all commands adhere to the syntax described here. 
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300, 300s _ 

handle special functions of DASI 300 and 300s termi¬ 

nals 

Syntax 

300 [ +12 ][-«][ -dt,l,c ] 

300s [ +12 ][-«][ -dt,l,c ] 

Description 

The 300 command supports special functions and optimizes the use of 
the DASI 300 (GSI 300 or DTC 300) terminal; 300s performs the same 
functions for the DASI 300s (GSI 300s or DTC 300s) terminal. It con¬ 
verts half-line forward, half-line reverse, and full-line reverse motions 
to the correct vertical motions. In the following discussion of the 300 
command, it should be noted that unless your system contains the text 
processing software, references to certain commands (e.g., nroff, 
neqn, eqn, etc.) will not work. It also attempts to draw Greek letters 
and other special symbols. It permits convenient use of 12-pitch text. 
It also reduces printing time 5 to 70%. The 300 command can be used 
to print equations neatly, in the sequence: 

neqn file ... | nroff | 300 

WARNING: if your terminal has a PLOT switch, make sure it is turned 
on before 300 is used. 

The behavior of 300 can be modified by the optional flag arguments to 
handle 12-pitch text, fractional line spacings, messages, and delays. 

+12 permits use of 12-pitch, 6 lines/inch text. DASI 300 termi¬ 
nals normally allow only two combinations: 10-pitch, 6 
lines/inch, or 12-pitch, 8 lines/inch. To obtain the 12-pitch, 
6 lines per inch combination, the user should turn the 
PITCH switch to 12, and use the +12 option. 
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•n controls the size of half-line spacing. A half-line is, by 

default, equal to 4 vertical plot increments. Because each 
increment equals 1/48 of an inch, a 10-pitch line-feed 
requires 8 increments, while a 12-pitch line-feed needs 
only 6. The first digit of n overrides the default value, thus 
allowing for individual taste in the appearance of sub¬ 
scripts and superscripts. For example, wo/half-lines could 
be made to act as quarter-lines by using -2. The user could 
also obtain appropriate half-lines for 12-pitch, 8 lines/inch 
mode by using the option -3 alone, having set the PITCH 
switch to 12-pitch. 

-At,l,c controls delay factors. The default setting is -d3,90,30. 

DASI 300 terminals sometimes produce peculiar output 
when faced with very long lines, too many tab characters, 
or long strings of blankless, non-identical characters. One 
null (delay) character is inserted in a line for every set of t 
tabs, and for every contiguous string of c non-blank, non¬ 
tab characters. If a line is longer than / bytes, l+(total 
length)/20 nulls are inserted at the end of that line. Items 
can be omitted from the end of the list, implying use of the 
default values. Also, a value of zero for t (c) results in two 
null bytes per tab (character). The former may be needed 
for C programs, the latter for files like /etc/passwd. 
Because terminal behavior varies according to the specific 
characters printed and the load on a system, the user may 
have to experiment with these values to get correct output. 
The -d option exists only as a last resort for those few cases 
that do not otherwise print properly. For example, the file 
/etc/passwd may be printed using -d3,30,5. The value 
■d0,l is a good one to use for C programs that have many 
levels of indentation. 

Note that the delay control interacts heavily with the pre¬ 
vailing carriage return and line-feed delays. The stty(C) 
modes nlO cr2 or nlO cr3 are recommended for most uses. 

The 300 command can be used with the nroff -s flag or .rd requests, 
when it is necessary to insert paper manually or change fonts in the 
middle of a document. Instead of hitting the return key in these cases, 
you must use the line-feed key to get any response. 

In many (but not all) cases, the following sequences are equivalent: 

nroff-T300 files ... and nroff files ... I 300 
nroff -T300-12 files... and nroff files ... | 300+12 

The use of 300 can thus often be avoided unless special delays or 
options are required; in a few cases, however, the additional move¬ 
ment optimization of 300 may produce better aligned output. 
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See Also 


300 (C) 


450(C), mesg(C), graph(ADM), stty(C), tabs(C), tplot(ADM) 

Notes 

Some special characters cannot be correctly printed in column 1 
because the print head cannot be moved to the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction- 
feed platen instead of a forms tractor; although good enough for drafts, 
the latter has a tendency to slip when reversing direction, distorting 
Greek characters and misaligning the first line of text after one or 
more reverse line-feeds. 
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4014 __ 

paginator for the TEKTRONIX 4014 terminal 

Syntax 

4014 [ -t ] [ -n ] [ -cN ] [ -pL ] [ file ] 

Description 


The output of 4014 is intended for a TEKTRONIX 4014 terminal; 
4014 arranges for 66 lines to fit on the screen, divides the screen into 
N columns, and contributes an eight-space page offset in the (default) 
single-column case. Tabs, spaces, and backspaces are collected and 
plotted when necessary. TELETYPE Model 37 half- and reverse-line 
sequences are interpreted and plotted. At the end of each page, 4014 
waits for a new-line (empty line) from the keyboard before continuing 
on to the next page. In this wait state, the command \cmd will send 
the cmd to the shell. 

The command line options are: 

-t Do not wait between pages (useful for directing output into a file). 

-n Start printing at the current cursor position and never erase the 
screen. 

-c N 

Divide the screen into N columns and wait after the last column. 

-P L 

Set page length to L; L accepts the scale factors i (inches) and 1 
(lines); default is lines. 

See Also 


pr(C) 
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450 _ 

handle special functions of the DASI 450 terminal 

Syntax 

450 

Description 

The 450 command supports special functions of, and optimizes the 
use of, the DASI 450 terminal, or any terminal that is functionally 
identical, such as the Diablo 1620 or Xerox 1700. It converts half-line 
forward, half-line reverse, and full-line reverse motions to the correct 
vertical motions. It also attempts to draw Greek letters and other spe¬ 
cial symbols in the same manner as 300(C). It should be noted that, 
unless your system contains text processing software, certain com¬ 
mands (e.g., eqn, nroff, tbl, etc.) will not work. Use 450 to print 
equations neatly, in the sequence: 

neqn file ... | nroff | 450 

WARNING: Make sure that the PLOT switch on your terminal is ON 
before 450 is used. The SPACING switch should be put in the desired 
position (either 10- or 12-pitch). In either case, vertical spacing is 6 
lines/inch, unless dynamically changed to 8 lines per inch by an 
appropriate escape sequence. 

Use 450 with the nroff -s flag or ,rd requests when it is necessary to 
insert paper manually or change fonts in the middle of a document. 
Instead of hitting the return key in these cases, you must use the line¬ 
feed key to get any response. 

In many (but not all) cases, the use of 450 can be eliminated in favor 
of one of the following: 

nroff-T450 files ... 
or 

nroff -T450-12 files ... 

The use of 450 can thus often be avoided unless special delays or 
options are required; in a few cases, however, the additional move¬ 
ment optimization of 450 may produce better aligned output. 

See Also 


300(C), mesg(C), stty(C), tabs(C), graph(ADM), tplot(ADM) 
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Notes 


Some special characters cannot be correctly printed in column 1 
because the print head cannot be moved to the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction- 
feed platen instead of a forms tractor; although good enough for drafts, 
the latter has a tendency to slip when reversing direction, distorting 
Greek characters and misaligning the first line of text after one or 
more reverse line-feeds. 
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assign, deassign_ 

assigns and deassigns devices 

Syntax 

assign [ -u ] [ -v ] [ -d ] [ device ] ... 
deassign [ -u ] [ -v ] [ device ]... 

Description 

assign attempts to assign device to the current user. The device argu¬ 
ment must be an assignable device that is not currently assigned. An 
assign command without an argument prints a list of assignable de¬ 
vices along with the name of the user to whom they are assigned. 

deassign is used to “deassign” devices. Without any arguments, 
deassign will deassign all devices assigned to the user. When argu¬ 
ments are given, an attempt is made to deassign each device given as 
an argument. 

With these commands you can exclusively use a device, such as a tape 
drive or floppy drive. This keeps other users from using the device. 
They have a similar effect as chown(C ) and chmod( C), although they 
only act on devices in /dev. Other aspects are discussed further on. 

Available options include: 

-d Performs the action of deassign . The -d option can be embedded 
in device names to assign some devices and deassign others. 

-v Gives verbose output. 

-u Suppresses assignment or deassignment, but performs error check¬ 
ing. 

The assign command will not assign any assignable devices if it can¬ 
not assign all of them, deassign gives no diagnostic if the device can¬ 
not be deassigned. Devices can be automatically deassigned at 
logout, but this is not guaranteed. Device names can be just the begin¬ 
ning of the device required. For example, 

assign fd 

should be used to assign all floppy disk devices. Raw versions of de¬ 
vice will also be assigned, e.g., the raw floppy disk devices /dev/rfd? 
would be assigned in the above example. 
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Note that in many installations the assignable devices such as floppy 
disks have general read and write access, so the assign command may 
not be necessary. This is particularly true on single-user systems. De¬ 
vices supposed to be assignable with this command should be owned 
by the user asg. The directory /dev should be owned by bin and have 
mode 755. The assign command (after checking for use by someone 
else) will then make the device owned by whoever invokes the com¬ 
mand, without changing the access permissions. This allows the sys¬ 
tem administrator to set up individual devices that are freely avail¬ 
able, assignable (owned by asg), or nonassignable and restricted (not 
owned by asg and with some restricted mode). 

Note that the first time assign is invoked, it builds the assignable de¬ 
vices table /etc/atab. This table is used in subsequent invocations to 
save repeated searches of the /dev directory. If one of the devices in 
/dev is changed to be assignable or unassignable (i.e., owned by asg), 
then /etc/atab should be removed (by the super-user) so that a correct 
list will be built the next time the command is invoked. 

Files 


/etc/atab Table of assignable devices 
/dev/asglock File to prevent concurrent access 

Diagnostics 


Exit code 0 returned if successful, 1 if problems, 2 if device cannot be 
assigned. 
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at, batch __ 

executes commands at a later time 


Syntax 

at time [ date ] [ increment ] 
at -r job-id ... 
at -1[ job-id ... ] 

at -qletter time [date] [increment] 

batch 

Description 

at and batch both accept one or more commands from the standard 
input to be executed at a later time, at and batch differ in the way the 
set of commands, or job, is scheduled: at allows you to specify a time 
when the job should be executed, while batch executes the job when 
the system load level permits. After a job is queued with either com¬ 
mand, the program writes a job identifier (a number and a letter), 
along with the time the job will execute, to standard error. 

at takes the following arguments: 

time The time can be specified as 1, 2, or 4 digits. One- and two- 
digit numbers are taken to be hours, four digits to be hours and 
minutes. The time can alternately be specified as two numbers 
separated by a colon, meaning hour:minute. A suffix am or pm 
can be appended; otherwise a 24-hour clock time is understood. 
The suffix zulu can be used to indicate Greenwich Mean Time 
(GMT). The special names noon, midnight, and now are also 
recognized. 

date An optional date can be specified as either a month name fol¬ 
lowed by a day number (and possibly year number preceded by 
an optional comma) or a day of the week (fully spelled or abbre¬ 
viated to three characters). Two special “days,” today and 
tomorrow, are recognized. If no date is given, today is 
assumed if the given hour is greater than the current hour and 
tomorrow is assumed if it is less. If the given month is less 
than the current month (and no year is given), next year is 
assumed. 
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increment 

The time and optional date arguments can be modified with an 
increment argument of the form “+n units", where n is an 
integer and units is one of the following: minutes, hours, days, 
weeks, months, or years. The singular form is also accepted, 
and “+1 unit 99 can also be written “next unit". Thus, legiti¬ 
mate commands include: 

at 0815am Jan 24 
at 8:15am Jan 24 
at now + 1 day 
at 5 pm Friday next week 

-r job-id... 

Removes the specified job or jobs previously scheduled by the at 
or batch command, job-id is a job identifier returned by at or 
batch. Unless you are the super-user, you can only remove your 
own jobs. 


-I [job-id ... ] 

Lists schedule times of specified jobs. If no job-ids are specified, 
lists all jobs currently scheduled for the invoking user. Unless you 
are the super-user, you can only list your own jobs. 

-qletter 

Places the specified job in a queue denoted by letter, where letter 
is any lowercase letter from “a” to “z”. The queue letter is 
appended to the job identifier. The following letters have special 
significance: 

a at queue 
b batch queue 
c cron queue 

For more information on the use of different queues, see the 
queuedefs{ F) manual page. 

batch takes no arguments; it submits a job for immediate execution at 
lower priority than an ordinary at job. 

at and batch jobs are executed using sh( C). Standard output and stan¬ 
dard error output are mailed to the user unless they are redirected else¬ 
where. The shell environment variables, current directory, umask, and 
ulimit are retained when the commands are executed. Open file 
descriptors, traps, and priorities are lost. 

Users are permitted to use at and batch if their names appear in the 
file /usr/lib/cron/at.allow. If that file does not exist, the file 
/usr/lib/cron/at.deny is checked to determine if a given user should 
be denied access to at and batch. If neither file exists, only root is 
allowed to submit a job. If only the at.deny file exists, and it is empty, 
global usage is permitted. The allow/deny files consist of one user 
name per line. 
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Examples 


The simplest way to use at is to place a series of commands in a file, 
one per line, and execute these commands at a specified time with the 
following command: 

at time < file 

The following sequence can be used at a terminal to format the file 
infile using the text formatter nrojfiCT), and place the output in the file 
outfile. 

batch 

nroff infile > outfile 
(CTL)-d 

The next example demonstrates redirecting standard error to a pipe 
(I), which is useful in a shell procedure. The file infile is formatted 
and the output placed in outfile , with any errors generated being 
mailed to user (output redirection is covered on the sh(C) manual 
page). 

batch «! 

nroff infile 2>&1 >outfile I mail user 


To have a job reschedule itself, invoke at from within the job. For 
example, if you want shellfile to run every Thursday, executing a 
series of commands and then rescheduling itself for the next Thursday, 
you can include code similar to the following within shellfile : 

echo "sh shellfile " I at 1900 thursday next week 


Files 


/usr/lib/cron 


main cron directory 


/usr/lib/cron/at.allow list of allowed users 

Aisr/lib/cron/at.deny list of denied users 

Aisr/lib/cron/queuedefs scheduling information 

Aisr/spool/cron/atjobs spool area 
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See Also 


AT(C) 


cron(C), kill(C), mail(C), nice(C), ps(C), sh(C), queuedefs(F) 

Diagnostics 

Complains about syntax errors and times out of range. 

Standards Conformance 

at and batch are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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auths _ 

list and/or restrict kernel authorizations 

Syntax 

auths [ -v ] [ -a authlist ] [ -r authlist ] [ -c command ] 

Description 


auths performs actions associated with system privilege manipulation. 
With no arguments, auths returns the kernel authorizations associated 
with the current process. All other uses of auths are discussed below. 

Either of the -a or -r options allow the user to alter the kernel authori¬ 
zations in order to run a shell or a single command. The -a option 
requires a list of comma-separated authorizations, which become the 
absolute set of kernel authorizations for the new process. This new set 
must be a subset of the kernel authorizations of the invoking process. 
To start a process with a null set of kernel authorizations, use the 
empty string The -r option also takes as argument a comma 
separated list of authorizations. These are removed from the authori¬ 
zation set of the invoking process when forming the kernel authoriza¬ 
tions for the new process. 

The argument to the -c option is passed to the user’s shell as specified 
in the user’s /etc/passwd entry which is run as a single command. The 
user’s shell must support the 

-c command 

syntax similar to sh(C). When the argument is absent (and -a or -r is 
specified), the user’s shell is invoked as a process with adjusted 
authorizations. Exiting that shell will resume execution in the previ¬ 
ous shell and the original kernel authorizations will be in effect. This 
option may be used to run a command with restricted authorizations, 
i.e. fewer than those allowed the user in the protected Password data¬ 
base entry. 

The -v option lists the new kernel authorizations before the new com¬ 
mand or shell is run. It also warns with the -a option when more 
authorizations are attempted to be set than already exist or with the -r 
option when more authorizations are attempted to be removed than 
already exist. 
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The kernel authorizations are: 

execsuid - allows the running of SUID programs 

nopromain - does not restrict file access when running SUID 

programs 

writeaudit - process can write directly to the audit trail 
configaudit - process can change audit subsystem parameters 
suspendaudit - process is not audited by the kernel 
chmodsugid - process can set SUID and GID bits on files 
chown - process can change file ownership 

Examples 


To execute a shell without the execsuid kernel authorization: 
auths -r execsuid 

To list the current kernel authorizations: 


auths 

To execute yourprog with no kernel authorizations: 

auths -a "" -c yourprog 

To execute myprog with chmodsugid and execsuid: 
auths -a chmodsugid,execsuid -c myprog 

See Also 

sh(C), promain(M), getpriv(S), setpriv(S), getprpwent(S), “Using a 
Trusted System” in the User’s Guide 
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awk __ 

pattern scanning and processing language 

Syntax 

awk [ -F re ] [ parameter... ] [ ’prog’ ] [ -f progfile ] [ file... ] 

Description 


The -F re option defines the input field separator to be the regular 
expression re. 

Parameters, in the form x=... y=... may be passed to awk, where x and 
y are awk built-in variables (see list below). 

awk scans each input file for lines that match any of a set of patterns 
specified in prog. The prog string must be enclosed in single quotes 
(’) to protect it from the shell. For each pattern in prog there may be 
an associated action performed when a line of a file matches the pat¬ 
tern. The set of pattern-action statements may appear literally as prog 
or in a file specified with the -f progfile option. 

Input files are read in order; if there are no files, the standard input is 
read. The file name - means the standard input. Each input line is 
matched against the pattern portion of every pattern-action statement; 
the associated action is performed for each matched pattern. 

An input line is normally made up of fields separated by white space. 
(This default can be changed by using the FS built-in variable or the 
-F re option.) The fields are denoted $1, $2,...; $0 refers to the entire 
line. 

A pattern-action statement has the form: 
pattern { action } 

Either pattern or action may be omitted. If there is no action with a 
pattern, the matching line is printed. If there is no pattern with an 
action, the action is performed on every input line. 

Patterns are arbitrary Boolean combinations ( !, | |, &&, and 
parentheses) of rational expressions and regular expressions. A rela- 
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tional expression is one of the following: 

expression relop expression 
expression matchop regular expression 

where a relop is any of the six relational operators in C, and a matchop 
is either ~ (contains) or ! ~ (does not contain). A conditional is an 
arithmetic expression, a relational expression, the special expression 

var in array, 

or a Boolean combination of these. 

The special patterns BEGIN and END may be used to capture control 
before the first input line has been read and after the last input line has 
been read respectively. 

Regular expressions are as in egrep (see grep(C)). In patterns they 
must be surrounded by slashes. Isolated regular expressions in a pat¬ 
tern apply to the entire line. Regular expressions may also occur in 
relational expressions. A pattern may consist of two patterns 
separated by a comma; in this case, the action is performed for all 
lines between an occurrence of the first pattern and next occurrence of 
the second pattern. 

A regular expression may be used to separate fields by using the -F re 
option or by assigning the expression to the built-in variable FS . The 
default is to ignore leading blanks and to separate fields by blanks 
and/or tab characters. However, if FS is assigned a value, leading 
blanks are no longer ignored. 

Other built-in variables include: 

ARGC command line argument count 

ARGV command line argument array 

FILENAME name of the current input file 

FNR ordinal number of the current record in the current file 

FS input field separator regular expression (default blank) 

NF number of fields in the current record 

NR ordinal number of the current record 

OFMT output format for numbers (default %.6g) 

OFS output field separator (default blank) 

ORS output record separator (default new-line) 

RS input record separator (default new-line) 
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An action is a sequence of statements. A statement may be one of the 
following: 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

do statement while ( conditional ) 

for ( expression ; conditional ; expression ) statement 

for ( var in array ) statement 

delete array [subscript] 

break 

continue 

{ [ statement ] ... } 

expression # commonly variable = expression 
print [ expression-list ] [ Expression ] 
printf format [ , expression-list ] [ Expression ] 
next # skip remaining patterns on this input line 

exit [expr] # skip the rest of the input; exit status is expr 
return [expr] 

Statements are terminated by semicolons, new lines, or right braces. 
An empty expression-list stands for the whole input line. Expressions 
take on string or numeric values as appropriate, and are built using the 
operators +, -, *, /, %, and concatenation (indicated by a blank). The 
C operators ++, —, +=, -=, *=, /=, and %= are also available in 
expressions. Variables may be scalars, array elements (denoted x[i]), 
or fields. Variables are initialized to the null string or zero. Array 
subscripts may be any string, not necessarily numeric; this allows for a 
form of associative memory. String constants are quoted ("). 

The print statement prints its arguments on the standard output, or on 
a file if Expression is present, or on a pipe if | cmd is present. The 
arguments are separated by the current output field separator and ter¬ 
minated by the output record separator. The printf statement formats 
its expression list according to the format (see printf(S) in the 
Programmer’s Reference). 

awk has a variety of built-in functions: arithmetic, string, 
input/output, and general. 

The arithmetic functions are: atan2, cos, exp, int, log, rand, sin, sqrt, 
and srand. int truncates its argument to an integer, rand returns a ran¬ 
dom number between 0 and 1. srand ( expr ) sets the seed value for 
rand to expr or uses the time of day if expr is omitted. 

The string functions are: 


gsubifor, repl, in) 

behaves like sub (see below), except that it replaces 
successive occurrences of the regular expression 
(like the ed global substitute command). 
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index(s, t) 


length ($) 


matches, re) 


splits, a,fs ) 


returns the position in string s where string t first 
occurs, or 0 if it does not occur at all. 

returns the length of its argument taken as a string, or 
of the whole line if there is no argument. 

returns the position in string s where the regular 
expression re occurs, or 0 if it does not occur at all. 
RSTART is set to the starting position (which is the 
same as the returned value), and RLENGTH is set to 
the length of the matched string. 

splits the string s into array elements a[l], a[2 ], a[ri\, 
and returns n. The separation is done with the regu¬ 
lar expression fs or with the field separator FS if fs is 
not given. 


sprintflfmt, expr, expr,...) 

formats the expressions according to the primfiS) 
format given by fmt and returns the resulting string. 

sublfor, repl, in) substitutes the string repl in place of the first 
instance of the regular expression for in string in and 
returns the number of substitutions. If in is omitted, 
awk substitutes in the current record ($0). 

substr(s, m, n) returns the ^-character substring of s that begins at 
position m. 


The input/output and general functions are: 

closeifilename) closes the file or pipe named filename. 

cmd\ get line pipes the output of and into getline', each successive 

call to getline returns the next line of output from 
cmd. 


getline 

getline <file 
getline var 


sets $0 to the next input record from the current input 
file. 

sets $0 to the next record from file. 
sets variable var instead. 


getline var <file sets var from the next record of file. 

system(cmd) executes cmd and returns to its exit status. 

All forms of getline return 1 for successful input, 0 for end of file and 
-1 for an error. 
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awk also provides user-defined functions. Such functions may be 
defined (in the pattern position of a pattern-action statement) as 

function name(args,...) { stmts } 
func name(args,...) { stmts } 

Function arguments are passed by value if scalar and by reference if 
array name. Argument names are local to the function; all other vari¬ 
able names are global. Function calls may be nested and functions 
may be recursive. The return statement may be used to return a 
value. 

Examples 


Print lines longer than 72 characters: 

length > 72 

Print first two fields in opposite order: 

{ print $2, $1 } 

Same, with input fields separated by comma and/or blanks and tabs: 

BEGIN { FS - ",[ \t]*[ \t]+" } 

{ print $2, $1 } 

Add up the first column, print sum and average: 

{ s += $1 } 

end { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; —i) print $i } 

Print all lines between start/stop pairs: 

/start/, /stop/ 

Print all lines whose first field is different from previous one: 

$1 != prev { print; prev = $1 } 
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Simulate echo{C ): 


BEGIN { 

for (i = 1; i < ARGC; i++) 

printf "%s n , ARGV[i] 
printf "\n H 
exit 
} 

Print file, filling in page numbers starting at 5: 


/Page/ { $2 = n++; } 
{ print } 


command line: awk -f program n=5 input 


See Also 


grep(C), sed(C), lex(CP), printf(S) 

Notes 


Input white space is not preserved on output if fields are involved. 

There are no explicit conversions between numbers and strings. To 
force an expression to be treated as a number add 0 to it; to force it to 
be treated as a string concatenate the null string (" ") to it. 

Standards Conformance 


awk is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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banner 

prints large letters 

Syntax 

banner strings 

Description 


banner prints its arguments (each up to 10 characters long) in large 
letters on the standard output. This is useful for printing names at the 
front of printouts. 

See Also 


echo(C) 

Standards Conformance 


banner is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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basename _ 

removes directory names from pathnames 

Syntax 


basename string [ suffix ] 

Description 


basename deletes any prefix ending in / and the suffix (if present in 
string) from string , and prints the result on the standard output. The 
result is the “base” name of the file, i.e., the filename without any 
preceding directory path and without an extension. It is used inside 
substitution marks ( v v ) in shell procedures to construct new 
filenames. 

The related command dir name deletes the last level from string and 
prints the resulting path on the standard output. 

Examples 


The following command displays the filename memos on the standard 
output: 

basename /usr/johnh/memos.old .old 

The following shell procedure, when invoked with the argument 
/usr/src/cmd/cat.c, compiles the named file and moves the output to a 
file named cat in the current directory: 

cc $1 

mv a.out v basename $1 .c v 

See Also 


dimame(C), sh(C) 

Standards Conformance 


basename is conformant with: 

The X/Open Portability Guide II of January 1987. 
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be_ 

invokes a calculator 


Syntax 


be [ -c ] [ -1 ] [ file ... ] 


Description 


be is an interactive processor for a language that resembles C but pro¬ 
vides unlimited precision arithmetic. It takes input from any files 
given, then reads the standard input. The -1 argument stands for the 
name of an arbitrary precision math library. The syntax for be pro¬ 
grams is as follows: L means the letters a-z, E means expression, S 
means statement. 

Comments: 

Enclosed in /* and */ 


Names: 


Simple variables: L 
Array elements: L [ E ] 

The words “base”, “ibase”, “obase”, and “scale”; 
“ibase” are interchangeable. 


“base” and 


Other operands: 

Arbitrarily long numbers with optional sign and decimal point 
(E) 

sqrt(E) 

length (E) Number of significant decimal digits 
scale (E) Number of digits right of decimal point 

L (E ,..., E) 

Additive operators: 

+ 


Multiplicative operators: 

* 

/ 

% (remainder) 

A (exponentiation) 
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Unary operators: 


++ 

(prefix and postfix; apply to names) 
Relational operators: 

<= 

>= 

i = 

< 

> 

Assignment operators: 


=+ 

=* 

=/ 

=% 


Statements: 

E 

{ S ;; S } 
if (E) S 
while (E) S 
for (E; E ; E) S 
null statement 
break 
quit 

Function definitions: 

define L (L,..., L) { 
auto L,..., L 
S;... S 
return (E) 

} 
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Functions in -1 math library: 

s(x) Sine 

c(x) Cosine 

e(x) Exponential 

l(x) Log 

a(x) Arctangent 

j(n,x) Bessel function 


All function arguments are passed by value. 

The value of a statement that is an expression is printed unless the 
main operator is an assignment. Either semicolons or newlines may 
separate statements. Assignment to scale influences the number of 
digits to be retained on arithmetic operations in the manner of dc( C). 
Assignments to ibase or obase set the input and output number radix 
respectively. 

The same letter may be used as an array, a function, and a simple vari¬ 
able simultaneously. All variables are global to the program. “Auto” 
variables are pushed down during function calls. When using arrays 
as function arguments or defining them as automatic variables, empty 
square brackets must follow the array name. 

be is actually a preprocessor for dc( C), which it invokes automatical¬ 
ly, unless the -c (compile only) option is present. If the -c option is 
present, the dc input is sent to the standard output instead. 

Example 


The following defines a function to compute an approximate value of 
the exponential function: 


scale = 20 
define e(x){ 

auto a, b, c, i, s 
a = 1 
b = 1 
s = 1 

for(i=l; 1==1; i++) { 
a = a*x 
b = b*i 
c = a/b 

if(c == 0) return(s) 
s = s+c 
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The following prints the approximate values of the exponential func¬ 
tion of the first ten integers: 

for(i=l; i<=10; i++) e(i) 

Files 

/usr/lib/lib.bc Mathematical library 

/usr/bin/dc Desk calculator propter 

See Also 

dc(C) 

User’s Guide 

Notes 

A For statement must have all three E’s. 

Quit is interpreted when read, not when executed. 

Trigonometric values should be given in radians. 
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bdiff 


compares files too large for diff(C) 

Syntax 


bdiff filel file2 [n] [-s] 

Description 



bdiff compares two files, finds lines that are different, and prints them 
on the standard output. It allows processing of files that are too large 
for dijf. bdiff splits each file into n-line segments, beginning with the 
first nonmatching lines, and invokes diff upon the corresponding seg¬ 
ments. The arguments are: 

n The number of lines bdiff splits each file into for processing. The 
default value is 3500. This is useful when 3500-line segments are 
too large for diff. 

-s Suppresses printing of bdiff diagnostics. Note that this does not 
suppress printing of diagnostics from diff. 

If file 1 (or file!) is a dash (-), the standard input is read. 

The output of bdiff is exactly that of diff. Line numbers are adjusted to 
account for the segmenting of the files, and the output looks as if the 
files had been processed whole. 


Files 


/tmp/bd????? 


See Also 


dififfC) 


Notes 



Because of the segmenting of the files, bdiff does not necessarily find a 
smallest sufficient set of file differences. 

Specify the maximum number of lines if the first difference is too far 
down in the file for diff and an error is received. 
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bfs_ 

scans big files 

Syntax 


bfs [ - ] name 

Description 


bfs is like ed (C) except that it is read-only and processes much larger 
files. Files can be up to 1024K bytes and 32K lines, with up to 255 
characters per line, bfs is usually more efficient than ed for sc annin g 
a file, since the file is not copied to a buffer. It is most useful for iden¬ 
tifying sections of a large file where csplit( C) can be used to divide it 
into more manageable pieces for editing. 

Normally, the size of the file being scanned is printed, as is the size of 
any file written with the w command. The optional dash (-) 
suppresses printing of sizes. Input is prompted for with an asterisk (*) 
when “P” and RETURN are typed. The “P” acts as a toggle, so 
prompting can be turned off again by entering another “P” and a 
RETURN. Note that messages are given in response to errors only if 
prompting is turned on. 

All address expressions described under ed are supported. In addition, 
regular expressions may be surrounded with two symbols other than 
the standard slash (/) and (?): A greater-than sign (>) indicates down¬ 
ward search without wraparound, and a less-than sign (<) indicates 
upward search without wraparound. Note that parentheses and curly 
braces are special and need to be escaped with a backslash (\). Since 
bfs uses a different regular expression-matching routine from ed, the 
regular expressions accepted are slightly wider in scope (see 
regex (S)). Differences between ed and bfs are listed below: 

+ A regular expression followed by + means one or more times . 
For example, [0-9]+ is equivalent to [0-9][0-9]*. 

\{m\} \{m,\} \{m,u\} 

Integer values enclosed in \{ \} indicate the number of times 
the preceding regular expression is to be applied, m is the 
minimum number and u is a number, less than 256, which is 
the maximum. If only m is present (e.g.,\{m\}), it indicates 
the exact number of times the regular expression is to be 
applied. \{m,\} is analogous to \{m,infinity\}. The plus (+) 
and star (*) operations are equivalent to \{1,\} and \{0,\} 
respectively. 
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(...)$« The value of the enclosed regular expression is to be 
returned. The value will be stored in the (n+1 )th argument 
following the subject argument. At most ten enclosed regular 
expressions are allowed, regex makes its assignments uncon¬ 
ditionally. 

(...) Parentheses are used for grouping. An operator, e.g. *, +, ""I 

\{\}, can work on a single character or a regular expression 
enclosed in parenthesis. For example, \(a*\(cb+\)*\)$0. 

There is also a slight difference in mark names: only the letters “a” 
through “z” may be used, and all 26 marks are remembered. 

The e, g, v, k, p, q, w, =,! and null commands operate as described 
under ed except that e doesn’t remember filenames and g and v when 
given no arguments return the line after the line you were on. Com¬ 
mands such as —, +++-, +++=, -12, and +4p are accepted. Note that 
l,10p and 1,10 will both print the first ten lines. The f command only 
prints the name of the file being scanned; there is no remembered 
filename. The w command is independent of output diversion, trunca¬ 
tion, or crunching (see the xo, xt and xc commands, below). The fol¬ 
lowing additional commands are available: 


xf file 

Further commands are taken from the named file. When an 
end-of-file is reached, an interrupt signal is received, or an error 
occurs, reading resumes with the file containing the xf. xf com¬ 
mands may be nested to a depth of 10. 

xo [file ] . 

Further output from the p and null commands is diverted to the 
named file. If file is missing, output is diverted to the standard 
output. Note that each diversion causes truncation or creation 
of the file. 


This positions a label in a command file. The label is ter¬ 
minated by a newline, and blanks between the : and the start of 
the label are ignored. This command may also be used to insert 
comments into a command file, since labels need not be refer¬ 
enced. 


(.,. )xb /regular expression/label 

A jump (either upward or downward) is made to label it the 
command succeeds. It fails under any of the following condi¬ 
tions: 


1 . 


Either address is not between 1 and 


$. 


2. The second address is less than the first. 
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3. "Hie regular expression doesn’t match at least one line 
in the specified range, including the first and last lines. 

On success, dot (.) is set to the line matched and a jump is made 
to label. This command is the only one that doesn’t issue an 
error message on bad addresses, so it may be used to test 
whether addresses are bad before other commands are executed. 
Note that the command 

xb/7 label 

is an unconditional jump. 

The xb command is allowed only if it is read from somewhere 
other than a terminal. If it is read from a pipe only a downward 
jump is possible. 

xt number 

Output from the p and null commands is truncated to a max¬ 
imum of number characters. The initial number is 255. 

x\[digit] [ spaces ] [value] 

The variable name is the specified digit following the xv. 
xv5100 or xv5 100 both assign the value 100 to the variable 5. 
xv61,100p assigns the value l,100p to the variable 6. To refer¬ 
ence a variable, put a % in front of the variable name. For 
example, using the above assignments for variables 5 and 6: 

l,%5p 

1,%5 

%6 

prints the first 100 lines. 
g/%5/p 

globally searches for the characters 100 and prints each line 
containing a match. To escape the special meaning of %, a \ 
must precede it. For example, 

g/".*\%[cds]/p 

could be used to match and list lines containing printf charac¬ 
ters, decimal integers, or strings. 

Another feature of the xv command is that the first line of output 
from a UNIX command can be stored into a variable. 
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The only requirement is that the first character of value be a !. 
For example, 

xv5! cat junk 
!rm junk 
!echo "%5" 
xv6!expr %6 + 1 

puts the current line in variable 5, prints it, and increments the 
variable 6 by one. To escape the special meaning of! as the first 
character of value , precede it with a \. For example, 

xv A! date 

stores the value Idate into variable 7. 
xbz label 
xbn label 

These two commands test the last saved return code from the 
execution of a UNIX command (! command) or nonzero value, 
respectively, and jump to the specified label. The two examples 
below search for die next five lines containing the string size: 

xv55 
: 1 

/size/ 

xv5!expr %5 - 1 
!if0%5 != 0 exit 2 
xbn 1 
xv45 
: 1 

/size/ 

xv4!expr %4 -1 
!if 0%4 = 0 exit 2 
xbz 1 

xc [switch ] 

If switch is 1, output from the p and null commands is crunched; 
if switch is 0, it is not. Without an argument, xc reverses switch. 
Initially switch is set for no crunching. Crunched output has 
strings of tabs and blanks reduced to one blank and blank lines 
suppressed. 

See Also 


csplit(C), ed(C), umask(C) 
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BFS (C) 


? for errors in commands if prompting is turned off. Self-explanatory 
error messages when prompting is on. 
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cal_ 

prints a calendar 

Syntax 

cal [[ month ] year] 

Description 


cal prints a calendar for the specified year. If a month is also speci¬ 
fied, a calendar for that month only is printed. If no arguments are 
specified, the current, previous, and following months are printed, 
along with the current date and time. The year must be a number 
between 1 and 9999; month must be a number between 1 and 12 or 
enough characters to specify a particular month. For example, May 
must be given to distinguish it from March, but S is sufficient to 
specify September. If only a month string is given, only that month of 
the current year is printed. 

Notes 


Beware that “cal 84” refers to the year 84, not 1984. 

The calendar produced is that for England and her colonies. Note that 
England switched from the Julian to the Gregorian calendar in Sep¬ 
tember of 1752, at which time eleven days were excised from the year. 
To see the result of this switch, try “cal 9 1752”. 


Standards Conformance 

cal is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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calendar _ 

invokes a reminder service 

Syntax 

calendar [ - ] 

Description 


calendar consults the file calendar in the user’s current directory and 
mails him lines that contain today’s or tomorrow’s date. Most reason¬ 
able month-day dates, such as “Sep. 14,” “September 14”, and 
9/14 , are recognized, but not “14 September”, or “14/9”. 

On weekends “tomorrow” extends through Monday. Lines that con¬ 
tain the date of a Monday will be sent to the user on the previous Fri¬ 
day. This is not true for holidays. 

When an argument is present, calendar does its job for every user who 
has a file calendar in his login directory and sends the result to the 
standard output. Normally this is done daily, in the early morning 
under the control of cron (C). 

Files 


calendar 

/usr/lib/calprog To figure out today’s and tomorrow’s dates 

/etc/passwd 

/tmp/cal* 

See Also 


cron(C), mail(C) 

Notes 


To get reminder service, a user’s calendar file must have read permis¬ 
sion for all. 
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Standards Conformance 


CALENDAR(C) 


calendar is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cat __ 

concatenates and displays files 

Syntax 


cat [ -u ] [ -s ] [ -v ] [ -t ] [ -e ] file ... 

Description 


cat reads each file in sequence and writes it on the standard output. If 
no input file is given, or if a single dash (-) is given, cat reads from the 
standard input. The options are: 

-s Suppresses warnings about nonexistent files. 

-u Causes the output to be unbuffered. 

-v Causes non-printing characters (with the exception of tabs, new¬ 
lines, and form feeds) to be displayed. Control characters are dis¬ 
played as ‘“'X” (Ctrl-X), where X is the key pressed with the Ctrl 
key (for example, Ctrl-M is displayed as "M). The DEL character 
(octal 0177) is printed as Non-ASCII characters (with the 

high bit set) are printed as “M -x,” where x is the character 
specified by the seven low order bits. 

-t Causes tabs to be printed as “T’ and form feeds as “X”. This 
option is ignored if the -v option is not specified. 

-e Causes a “$” character to be printed at the end of each line (prior 
to the new-line). This option is ignored if the -v option is not set. 

No input file may have the same name as the output file unless it is a 
special file. 

Examples 


The following example displays file on the standard output: 
cat file 
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The following example concatenates filel and file2 and places the 
result in file3 : 

cat filel file2 >file3 

The following example concatenates filel and appends it to file2 : 
cat filel » file2 

See Also 

cp(C), pr(C) 

Warning 

Command lines such as: 
cat filel file2 > filel 

will cause the original data m filel to be lost; therefore, you must be 
careful when using special shell characters. 

Standards Conformance 


cat is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cd_ 

changes working directory 

Syntax 


cd [ directory ] 

Description 


If specified, directory becomes the new working directory; otherwise 
the value of the shell parameter $HOME is used. The process must 
have search (execute) permission in all directories (components) 
specified in the full pathname of directory. 

Because a new process is created to execute each command, cd would 
be ineffective if it were written as a normal command; therefore, it is 
recognized and executed by the shell. 

If the shell is reading its commands from a terminal, and the specified 
directory does not exist (or some component cannot be searched), 
spelling correction is applied to each component of directory , in a 
search for the “correct’ ’ name. The shell then asks whether or not to 
try and change directory to the corrected directory name; an answer of 
n means “no”, and anything else is taken as “yes”. 

Notes 


Wildcard designators will work with the cd command. 

See Also 


pwd(C), sh(C), chdir(S) 
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checkmaii ___ 

checks for mail which has been submitted but not 

delivered 

Syntax 

checkmaii [ -a ] [ -f ] [ -m ] 

Description 

checkmaii checks the mail queue on the local machine for messages 
which have been sent by the invoker. If invoked without any argu¬ 
ments, the “Subject:” of each message found is given along with a 
list of addressees that have not yet received the message. Usually, 
messages are still in the queue because the addressee’s host is down. 

The -a (all addresses) option causes all addresses to be shown (both 
delivered and undelivered). Some delivered addresses may not appear 
since some sites prune already delivered addresses from the address 
list files for efficiency. The -f (fast) option suppresses the printing of 
the “Subject” line. The -m (all messages) option causes checkmaii to 
check all messages in the mail queue, not just those of the invoker. 
This is only useful for mail system maintained who wish to find 
obstinate hosts. 

See Also 

send(ADM), deliver(ADM), mmdf(ADM) 
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chgrp __ 

changes group ID 

Syntax 

chgrp group file ... 

Description 

chgrp changes the group ID of each file to group. The group may be 
either a decimal group ID or a group name found in the file /etc/group. 

Files 

/etc/passwd 

/etc/group 

See Also 

chown(C), chown(S), passwd(F), group(F) 

Notes 

Only the owner or the super-user can change the group ID of a file. 

Standards Conformance 

chgrp is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide n of January 1987. 
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chmod _ 

changes the access permissions of a file or directory 

Syntax . 

chmod mode file 

chmod [who] [+1-1=] [permission ...] file ... 


Description 

The chmod command changes the access permissions (or mode) of a 
specified file or directory. It is used to control file and directory 
access by users other than the owner and super-user. The mode may 
be an expression composed of letters and operators (called symbolic 
mode), or a number (called absolute mode). 

A chmod command using symbolic mode has the form: 

chmod [who] [+1-1=] [permission ...] filename 

In place of who you can use one or any combination of the following 
letters: 

a Stands for “all users”. If who is not indicated on the command 
line, a is the default. The definition of “all users” depends on the 
user’s umask. See umaskiC). 

g Stands for “group”, all users who have the same group ID as the 
owner of the file or directory. 

o Stands for “others’ ’, all users on the system. 

u Stands for “user”, the owner of the file or directory. 

The operators are: 

+ Adds permission 
- Removes permission 

= Assigns the indicated permission and removes all other permis¬ 
sions (if any) for that who. If no permission is assigned, existing 
permissions are removed. 
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Permissions can be any combination of the following letters: 
x Execute (search permission for directories) 
r Read 
w Write 

s Sets owner or group ID on execution of the file to that of the owner 
of the file. The mode “u+s” sets the user ID bit for the file. The 
mode “g+s” sets the group ID bit. Other combinations have no 
effect. When the group ID bit is set on a directory, all files created 
under it thereafter receive the group ED of that directory. When 
the group ID bit is not set, files are created with the group ID of the 
creating process/user. 

t This is known as the “sticky bit.” (see chmod(S )). Only the mode 
“u+t” sets the sticky bit. All other combinations have no effect. 
When this bit is set on a directory, files within the directory cannot 
be removed by anyone but the owner or the super-user. The owner 
can set or remove the sticky bit. 

1 Mandatory locking will occur during access 

Multiple symbolic modes may be given, separated by commas, on a 
single command line. See the following Examples section for sample 
permission settings. 

Mandatory file and record locking refers to a file having locked read¬ 
ing or writing permissions while a program is accessing that file. A file 
cannot have group execution permission and be able to be locked on 
execution. In addition, it is not possible to turn on the set-group-ED 
and enable a file to be locked on execution at the same time. The fol¬ 
lowing examples show illegal uses of chmod and will generate error 
messages: 

chmod g+x,+l filename 
chmod g+s,+l filename 

A chmod command using absolute mode has the form: 
chmod mode filename 

where mode is an octal number constructed by perfo rming logical OR 
on the following: 

4000 Set user ID on execution 

20#0 Set group ID on execution if “#” is 7, 5, 3, or 1 and 
enable mandatory locking if “#” is 6,4,2, or 0. 
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1000 Sets the sticky bit (see chmod(S)) 

0400 Read by owner 

0200 Write by owner 

0100 Execute (search in directory) by owner 

0040 Read by group 

0020 Write by group 

0010 Execute (search in directory) by group 

0004 Read by others 

0002 Write by others 

0001 Execute (search in directory) by others 

0000 No permissions 

Examples 


Symbolic Mode 

The following command gives all users execute permission for file: 
chmod +x file 

The following command removes read and write permission for group 
and others from file: 

chmod go-rw file 

The following command gives other users read and write permission 
for file: 

chmod o+rw file 

The following command gives read permission to group and other: 
chmod g+r,o+r file 

Absolute Mode 
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The following command gives all users read, write and execute per- 
mission for file: 

chmod 0777 file 

The following command gives read and write permission to all users 
for file : 

chmod 0666 file 

The following command gives read and write permission to the owner 
of file only: 

chmod 0600 file 

The following example causes the file to be locked on access: 
chmod +1 file 

See Also 

ls(C), chmod(S) 

Notes 


The setuid, setgid and sticky bit settings have no effect on shell 
scripts. 

Standards Conformance 


chmod is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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chown____ 

changes owner ID 

Syntax 

chown owner file ... 

Description 

chown changes the owner ID of the files to owner. The owner may be 
either a decimal user ID or a login name found in the file /etc/passwd. 

Files 


/etc/passwd 

/etc/group 

See Also 


chgrp(C), chown(S), group(F), passwd(F) 

Notes 


Use of this utility is governed by the chown kernel authorization. If 
this authorization is not granted, ownership of files can only be 
changed by root. Restricted chown is required for NIST FIPS 151-1 
conformance. The chown authorization should not be assigned to 
users if you wish to conform to these requirements. 

Standards Conformance 


chown is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

NIST FIPS 151-1; 

and The X/Open Portability Guide II of January 1987. 
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clear 


clears a terminal screen 


Syntax 


clear [ term ] 


Description 



The clear command clears the screen. If term is not specified, the ter¬ 
minal type is obtained from the TERM environment variable. 

If a video terminal does not have a clear screen capability, newlines 
are output to scroll the screen clear. If the terminal is a hardcopy, the 
paper is advanced to the top of the next page. 

Files 


/etc/termcap 

See Also 


environ(M), termcap(F), tput(C) 

Notes 


If the standard output is not a terminal, clear issues an error message. 
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cmchk _ 

reports hard disk block size 

Syntax 

cmchk 

Description 

Reports the hard disk block size in 512-byte blocks. 

Value Added 

cmchk is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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CMP (C) 


cmp _ 

compares two files 

Syntax 


cmp [ -1 ] [ -s ] filel file2 

Description 


cmp compares two files and, if they are different, displays the byte and 
line number of the differences. If filel is -, the standard input is used. 

The options are: 

-I Prints the byte number (decimal) and the differing bytes (octal) 
for each difference. 

-s Returns an exit code only, 0 for identical files, 1 for different 
files and 2 for an inaccessible or missing file. 

This command should be used to compare binary files; use diff(C ) or 
dijf3 (C) to compare text files. 

See Also 


comm(C), diff(C), diff3(C) 

Standards Conformance 


cmp is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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COL (C) 


col _ 

filters reverse linefeeds 


Syntax 

col [ -bfxp ] 

Description 

col prepares output from processes, such as the text formatter 
nroff (Cl), for output on devices that limit or do not allow reverse or 
half-line motions, col is typically used to process nroff output text 
that contains tables generated by the tbl program. A typical command 
line might be: 

tbl file I nroff I col I lpr 
col takes the following options: 

-b Assumes the output device in use is not capable of backspacing. If 
two or more characters appear in the same place, col outputs the 
last character read. 

-f Allows forward half linefeeds. If not given, col accepts half line 
motions in its input, but text that would appear between lines is 
moved down to the next full line. Reverse full and half linefeeds 
are never allowed with this option. 

-x Prevents conversion of whitespace to tabs on output, col normally 
converts whitespace to tabs wherever possible to shorten printing 
time. 

-p Causes col to ignore unknown escape sequences found in its input 
and pass them to the output as regular characters. Because these 
characters are subject to overprinting from reverse line motions, 
the use of this option is discouraged unless the user is fully aware 
of the position of the escape sequences. 

col assumes that the ASCII control characters SO (octal 016) and SI 
(octal 017) start and end text in an alternate character set. If you have 
a reverse linefeed (ESC 7), reverse half linefeed (ESC 8), or forward 
half linefeed (ESC 9), within an SI-SO sequence, the ESC 7, 8 and 9 
are still recognized as line motions. 

On input, the only control characters col accepts are space, backspace, 
tab, return, newline, reverse linefeed (ESC 7), reverse half linefeed 
(ESC 8), forward half linefeed (ESC 9), alternate character start(SI), 
alternate character end (SO), and vertical tag (VT). (The VT 
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character is an alternate form of full reverse linefeed, included for 
compatibility with some earlier programs of this type.) All other non¬ 
printing characters are ignored. 

See Also 


nrofi(CT), tbl(CT) 

Notes 


col cannot back up more than 128 lines. 

col allows at most 800 characters, including backspaces, on a line. 

Vertical motions that would back up over the first line of the document 
are ignored. Therefore, the first line must not contain any superscripts. 

Standards Conformance 


col is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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COMM (C) 


comm _ _ _ 

selects or rejects lines common to two sorted files 


Syntax 

comm [ -123 ] filel file2 

Description 

comm reads filel and file2, which should be ordered in ASCII collat- 
ing sequence (see sort (C)), and produces a three-column output, lines 
only in filel ; lines only in file2 ; and lines in both files. The filename 
- means the standard input. 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus 
comm -12 prints only the lines common to the two files; comm -23 
prints only lines in the first file but not in the second; comm -123 is a 
no-op. 

See Also 


cmp(C), diff(C), sort(C), uniq(C) 

Standards Conformance 


comm is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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COMPRESS (C) 


compress, uncompress, zcat_ 

compress data for storage, uncompress and display 
compressed files 

Syntax 


compress [-dfFqc] [-b bits] file 
uncompress [-fqc] file 
zcat file 

Description 


compress takes a file and compresses it to the smallest possible size, 
creates a compressed output file, and removes the original file unless 
the -c option is present. Compression is achieved by encoding com¬ 
mon strings within the file, uncompress restores a previously 
compressed file to its uncompressed state and removes the 
compressed version, zcat uncompresses and displays a file on the stan¬ 
dard output. 

If no file is specified on the command line, input is taken from the 
standard input and the output is directed to the standard output. Output 
defaults to a file with the same filename as the input file with the suf¬ 
fix “.Z” or it can be directed through the standard output. The output 
files have the same permissions and ownership as the corresponding 
input files or the user’s standard permissions if output is directed 
through the standard output. 

If no space is saved by compression, the output file is not written 
unless die -F flag is present on the command line. 

Options 


The following options are available from the command line: 

-d Decompresses a compressed file. 

"C Writes output on the standard output and does not remove 

original file. 

-b bits Specifies the maximum number of bits to use in encoding. 

-f Overwrites previous output file. 

-F Writes output file even if compression saves no space. 
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-q Generates no output except error messages, if any. 

See Also 


pack(C), ar(C), tar(C), cat(C) 
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copy _ 

copies groups of files 

Syntax 

copy [ option ]... source ... dest 

Description 


The copy command copies the contents of directories to another direc¬ 
tory. It is possible to copy whole file systems since directories are 
made when needed. 

If files, directories, or special files do not exist at the destination, then 
they are created with the same modes and flags as the source. In addi¬ 
tion, the super-user may set the user and group ID. The owner and 
mode are not changed if the destination file exists. 

Note that there may be more than one source directory. If so, the 
effect is the same as if the copy command had been issued for each 
sourpe directory with the same destination directory for each copy. 

Options do not have to be given as separate arguments, and may 
appear in any order, even after the other arguments. The options are: 

-a Asks the user before attempting a copy. If the response does 
not begin with a “y”, then a copy is not done. When used 
together with the -v option, it overrides the verbose option 
so that messages regarding the copy action are not dis¬ 
played. 

-I Uses links instead whenever they can be used. Otherwise a 

copy is done. Note that links are never done for special files 
or directories. 

-n Requires the destination file to be new. If not, then the copy 
command does not change the destination file. The -n flag is 
meaningless for directories. For special files a -n flag is 
assumed (i.e., the destination of a special file must not 
exist). 

-o If set then every file copied has its owner and group set to 

those of the source. If not set, then the file’s owner is the 
user who invoked the program. 
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-m If set, then every file copied has its modification time and 
access time set to that of the source. If not set, then the 
modification time is set to the time of the copy. 

-r If set, then every directory is recursively examined as it is 

encountered. If not set then any directories that are found 
are ignored. 

-ad Asks the user whether a -r flag applies when a directory is 
discovered. If the answer does not begin with a y , then 
the directory is ignored. 

-v Messages are printed that reveal what the program is doing. 

If used with the -a option, the -a option is given priority so 
that it overrides the verbose option, and the copy action 
message is not displayed. 

Arguments to copy are: 

source This may be a file, directory or special file. It must exist. If 
it is not a directory, then the results of the command are the 
same as for the cp command. 

dest The destination must be either a file or directory name that 
is different from the source. 

If the source and destination are anything but directories, then copy 

acts just like a cp command. If both are directories, then copy copies 

each file into the destination directory according to the flags that have 

been set. 

Examples 


This command line verbosely copies all files in the current directory 

to /tmp/food: 

copy -v . /tmp/food 

The next command line copies all files, except for those that begin 
with a period (.), and copies the immediate contents of any child 
directories: 

copy * /tmp/logic 

This command is the same as the previous one, except that it recur¬ 
sively examines all subdirectories, and it sets group and ownership 
permissions on the destination files to be the same as the source files. 

copy -ro * /tmp/logic 
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Notes 


Special device files can be copied. When they are copied, any data 
associated with the specified device is not copied. 
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cp_ 

copies files 

Syntax 

cp filel file2 
cp files directory 

Description 


There are two ways to use the cp command. With the first way, filel 
is copied to file2 . Under no circumstance can filel and file2 be ident¬ 
ical. With the second way, directory is the location of a directory into 
which one or more files are copied. This directory must exist prior to 
the execution of the cp command. 

See Also 


copy(C), cpio(C), ln(C), mv(C), rm(C), chmod(S) 

Notes 


Special device files can be copied. If the file is a named pipe, then the 
data in the pipe is copied to a regular file. Similarly, if the file is a de¬ 
vice, then the file is read until the end-of-file is reached, and that data 
is copied to a regular file. It is not possible to copy a directory to a 
file. 

Standards Conformance 


cp is conformant with: 

AT&T SVED Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cpio 


copy file archives in and out 

Syntax 

cpio -o[acBvV] [-C bufsize] [[-O file] [-K volumesize] [-M mes¬ 
sage] ] 

cpio -i [ BcdmrtTuvVfsSb6k ] [-C bufsize ] [ [-1 file ] [-K volumesize ] 
[-M message] ] [pattern ...] 

cpio -p [ adlmuvV ] directory 

Description 

cpio -o (copy out) reads the standard input to obtain a list of path 
names and copies those files onto the standard output together with 
path name and status information. Output is padded to a 512-byte 
boundary by default. 

cpio -i (copy in) extracts files from the standard input, which is 
assumed to be the product of a previous cpio -o. Only files with 
names that match patterns are selected, patterns are regular expres¬ 
sions given in the filename-generating notation of sh( C). In patterns , 
metacharacters ?, *, and [...] match the slash (/) character, and 
backslash (\) is an escape character. A ! metacharacter means not. 
(For example, the !abc* pattern would exclude all files that begin with 
abc.) Multiple patterns may be specified and if no patterns are speci¬ 
fied, the default for patterns is * (i.e., select all files). Each pattern 
must be enclosed in double quotes otherwise the name of a file in the 
current directory is used. Extracted files are conditionally created and 
copied into the current directory tree based upon the options described 
below. The permissions of the files will be those of the previous cpio 
-o . The owner and group of the files Will be that of the current user 
unless the user is super-user, which causes cpio to retain the owner 
and group of the files of the previous cpio -o . NOTE: If cpio -i tries 
to create a file that already exists and the existing file is the same age 
or newer, cpio will output a warning message and not replace the file. 
(The -u option can be used to unconditionally overwrite the existing 
file.) 

cpio - p (pass) reads the standard input to obtain a list of path names of 
files that are conditionally created and copied into the destination 
directory tree based upon the options described below. Archives of 
text files created by cpio are portable between implementations of 
UNIX System V. 
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The meanings of the available options are: 

-a Reset access times of input files after they have been copied. 
Access times are not reset for linked files when cpio -pla is 
specified. 

-b Reverse the order of the bytes within each word. Use only with the 
-i option. 

-B Input/output is to be blocked 5,120 bytes to the record. The default 
buffer size is 512 bytes when this and the -C options are not used. 
(-B does not apply to the pass option; -B is meaningful only with 
data directed to or from a character-special device, e.g., 
/dev/rdsk/f0ql5dt.) 

-c Write header information in ASCII character form for portability. 
Always use this option when origin and destination machines are 
different types. 

-C bufsize 

Input/output is to be blocked bufsize bytes to the record, where buf¬ 
size is replaced by a positive integer. The default buffer size is 512 
bytes when this and -B options are not used. (-C does not apply to 
the pass option; -C is meaningful only with data directed to or 
from a character-special device, e.g., /dev/rmt/cOsO.) When used 
with the -K option, bufsize is forced to be a IK multiple. 

-d directories are to be created as needed. 

-f Copy in all files except those in patterns. (See the paragraph on 
cpio -i for a description of patterns.) 

-I file 

Read the contents of file as input. If file is a character-special de¬ 
vice, when the first medium is full, replace the medium and type a 
carriage return to continue to the next medium. Use only with the 
-i option. 

-k Attempt to skip corrupted file headers and I/O errors that may be 
encountered. If you want to copy files from a medium that is cor¬ 
rupted or out of sequence, this option lets you read only those files 
with good headers. (For cpio archives that contain other cpio 
archives, if an error is encountered, cpio may terminate prema¬ 
turely. cpio will find the next good header, which may be one for a 
smaller archive, and terminate when the smaller archive’s trailer is 
encountered.) Used only with the -i option. 

-1 Whenever possible, link files rather than copying them. Usable 
only with the -p option. 

-m Retain previous file modification time. This option is ineffective 
on directories that are being copied. 

-K volumesize 

Specifies the size of the media volume. Must be in IK blocks. For 
example, a 1.2 MB floppy disk has a volumesize of 1200. Must 
include the *C option with a bufsize multiple of IK. 
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-M message 

Define a message to use when switching media. When you use the 
-O or -I options and specify a character-special device, you can 
use this option to define the message that is printed when you 
reach the end of the medium. One %d can be placed in the mes¬ 
sage to print the sequence number of the next medium needed to 
continue. 

■O file 

Direct the output of cpio to file. If file is a character-special de¬ 
vice, when the first medium is full, replace the medium and type a 
carriage return to continue to the next medium. Use only with the 
-o option. 

-r Interactively rename files. If the user types a null line, the file is 
skipped. If the user types a the original pathname will be 
copied. (Not available with cpio -p.) 

-s swap bytes within each half word. Use only with the -i option. 

-S Swap halfwords within each word. Use only with the -i option. 

-T Truncate long filenames to 14 characters. Use only with the -i 
option. 

-t Print a table of contents of the input. No files are created. 

-u Copy unconditionally (normally, an older file will not replace a 
newer file with the same name). 

-v verbose : causes a list of file names to be printed. When used with 
the -t option, the table of contents looks like the output of an Is -1 
command [see ls(C)]. 

-V Special Verbose: print a dot for each file seen. Useful to assure the 
user that cpio is working without printing out all file names. 

-6 Process an old (i.e., UNIX System Sixth Edition format) file. Use 
only with the -i option. 

NOTE: cpio assumes 4-byte words. 

If cpio reaches end of medium (end of a diskette for example) when 
writing to (-o) or reading from (-i) a character-special device, and -O 
and -I are not used, cpio will print the message: 

If you want to go on , type device!file name when ready. 

To continue, you must replace the medium and type the character- 
special device name (/dev/rdsk/fOql5dt for example) and a carriage 
return. You may want to continue by directing cpio to use a different 
device. For example, if you have two floppy drives, you may want to 
switch between them so cpio can proceed while you are changing the 
floppies. (A carriage return alone causes the cpio process to exit.) 
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Examples 

The following examples show three uses of cpio. 

When standard input is directed through a pipe to cpio -o, it groups the 
files so they can be directed (>) to a single file (../newfile). The -c 
option insures that the file will be portable to other machines. Instead 
of ls(C), you could use find( C), echo (C), cat( C), etc., to pipe a list of 
names to cpio. You could direct the output to a device instead of a 
file. 

Is | cpio -oc >.. /newfile 

cpio -i uses the output file of cpio -o (directed through a pipe with cat 
in the example), extracts those files that match the patterns (memo/al, 
memo/b*), creates directories below the current directory as needed 
(-d option), and places the files in the appropriate directories. The -c 
option is used when the file is created with a portable header. If no 
patterns were given, all files from newfile would be placed in the 
directory. 

cat newfile | cpio -icd "memolal" "memolb*" 

cpio -p takes the file names piped to it and copies or links (-1 option) 
those files to another directory on your machine ( newdir in the exam¬ 
ple). The -d options says to create directories as needed. The -m 
option says retain the modification time. [It is important to use the 
-depth option of find(C) to generate path names for cpio. This elim¬ 
inates problems cpio could have trying to create files under read-only 
directories.] 

find . -depth -print | cpio -pdlmv newdir 

See Also 


cat(C), echo(C), find(C), ls(C), tar(C), cpio(F) 

Notes 


1) Path names are restricted to 256 characters. 

2) Only the super-user can copy special files. 

3) Blocks are reported in 512-byte quantities. 

4) If a file has 000 permissions, contains more than 0 characters of data, 
and the user is not root, the file will not be saved or restored. 

Standards Conformance 


cpio is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cron __ 

executes commands scheduled by at, batch, and 

crontab 

Syntax 

/etc/cron 

Description 

cron is the clock daemon that executes commands at specified dates 
and tunes, cron processes jobs submitted with at(C), batch (C), and - 
crontab (C). cron never exits; the cron command usually appears in 
the /etc/rc2 scripts to be invoked by init (M) when the system is 
brought up in multi-user mode. 

Files 

/etc/default/cron 
Aisr/lib/cron 
/usr/lib/cron/atjobs 
/usr/spool/cron/crontabs 
/usr/lib/cron/iog 
/usr/lib/cron/queuedefs 
/usr/lib/cron/.proto 

See Also 

at(C), crontab(C), queuedefs(F), sh(C) 

Diagnostics 


cron logging default information 
main cron directory 
at directory 
crontab directory 
accounting information 
cron data file 

cron environment information 


A history of all actions by cron can be recorded in /usr/lib/cron/iog 
pus logging occurs only if the variable CRONLOG is set to YES in 
/etc/default/cron. By default this value is set to NO and no logging 
occurs. If logging should be turned on, be sure to check the size of the 
log file regularly. 
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Standards Conformance 

cron is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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crontab __ 

schedule commands to be executed at regular inter¬ 

vals 


Syntax 


crontab [ file ] 
crontab -r 
crontab -1 

Description 


The crontab command can be used to schedule commands to be exe- 
cuted at regular intervals. These commands are stored in the user’s 
crontab file, /usr/spool/cron/ cront&bsl username. Any output or 
errors generated by the commands are mailed to the user. 

If called with no options, crontab copies the specified file, or standard 
mput if no file is specified, into the crontabs directory (if the user has 
a previous crontab file, it is replaced). 

The -r option removes the user’s crontab file from the crontab direc- 
tory. 

The -1 option lists the contents of the user’s crontab file. 

If the file /usr/lib/cron/cron.allow exists, only the users listed in that 
file are allowed to use crontab. If cron.allow does not exist, and the 
file /usr/lib/cron/cron.deny does, then all users not listed in 
cron.deny are allowed access to crontab , with an empty cron.deny 
allowing global usage. If neither file exists, only the super user is 
allowed to submit a job. The allow/deny files consist of one user name 
per lme. 

The crontabs files consist of lines of six fields each. The fields are 
separated by spaces or tabs. The first five are integer patterns that 
specify the minute (0-59), hour (0-23), day of the month (1-31), month 
of the year (1-12), and day of the week (0-6, with 0=Sunday). Each of 
these patterns may contain: 

- A number in the (respective) range indicated above 

- Two numbers separated by a minus (indicating an inclusive range) 
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- A list of numbers separated by commas (meaning all of these 
numbers) 

- An asterisk (meaning all legal values) 

Note that the specification of days may be made by two fields (day of 
the month and day of the week). If both are specified as a list of ele¬ 
ments, both are adhered to. For example, 0 0 1,15 * 1 would run a 
command on the first and fifteenth of each month, as well as on every 
Monday. To specify days by only one field, the other field should be 
set to * (for example, 0 0**1 would run a command only on Mon¬ 
days). 

The sixth field is a string that is executed by the shell at the specified 
time(s). A % in this field is translated into a newline character. Only 
the first line (up to a % or end-of-line) of the command field is exe¬ 
cuted by the shell. The other lines are made available to the command 
as standard input. 

The shell is invoked from your $HOME directory with an argO of sh. 
Users who desire to have their .profile executed must explicitly do so 
in the crontab file, cron supplies a default environment for every 
shell, defining HOME, LOGNAME, SHELL (=/bin/sh), and 
PATH (=/bin:/usr/bin:). 

Examples 


An example crontabs file follows: 


0 4 

15 4 

30 4 

40 4 


1,21,41 * 


* * * calendar - 

* * * find /usr/preserve -mtime +7 -exec rm -f {} ; 

1*1 /usr / lib/uucp/uuclean 

* * * find / -name '#*' -atime +3 -exec rm -f {} ; 

* * * (echo -n ' date; echo ) >/dev/console 


The lines in this example do the following: run the calendar program 
every night at 4:00 am, clear old files from the /etc/preserve directory 
every night at 4:15 am, clean up the uucp spool directory every Mon¬ 
day and the first of every month at 4:30 am, find and remove any old 
files with names beginning with “#” every night at 4:40 am, and echo 
the current date and time to the console three times an hour at one 
min ute, 21 minutes, and 41 minutes past the hour. 


Files 


/usr/lib/cron main cron directory 
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/usr/spool/cron/crontabs 

Aisr/lib/cron/cron.allow 

Aisr/lib/cron/cron.deny 

/usr/lib/cron/.proto 

/usr/lib/cron/queuedefs 

See Also 


crontab directory 

list of allowed users 

list of denied users 

cron environment information 

cron data file 


at(C), cron(C), sh(C) 

Diagnostics 


crontab exits and returns a value of 55 if it cannot allocate enough 
memory. If it exits for any other reason, it returns a value of 1. 

Notes 


crontab commands are executed by cron( C). cron reads the files in 
the crontabs directory only on startup or when a new crontab is sub¬ 
mitted with the crontab command, so changes made to these files by 
hand will not take effect until the system is rebooted. Changes sub¬ 
mitted with the crontab command will take effect as soon as cron is 
free to read them (that is, when cron is not in the process of running a 
scheduled job or reading another newly submitted at(C) or crontab 
job.). 

Users who do not wish to have output from their commands mailed to 
them may want to redirect it to a file: 

0 * * * * who » /tmp/whofile 2> /dev/null 

The example above would append the output of the who(C) command 
to a file, and throw away any errors generated. For more details on 
output redirection, see the sh(C) manual page. 

Users should remember to redirect the standard output and standard 
error of their commands otherwise any generated output or errors will 
be mailed to the user. 

crontab will overwrite any previous crontab submitted by the same 
user. 
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crontab is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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crypt 

encode/decQde 

Syntax 

crypt [ password ] 
crypt [-k] 

Description 


The crypt command reads from the standard input and writes to the 
standard output. The password is a key that selects a particular 
transformation. If no argument is given, crypt demands a key from the 
terminal and turns off printing while the key is being typed in. If the 
-k option is used, crypt will use the key assigned to the environment 
variable CRYPTKEY. The crypt command encrypts and decrypts with 
the same key: 

crypt key <clear >cypher 
crypt key <cypher | pr 

Files encrypted by crypt are compatible with those treated by the edi¬ 
tors ed( C), edit(C), ex(C), and v/(C) in encryption mode. 

The security of encrypted files depends on three factors: the funda¬ 
mental method must be hard to solve; direct search of the key space 
must be infeasible; “sneak paths” by which keys or clear text can 
become visible must be minimized. 

The crypt command implements a one-rotor machine designed along 
the lines of the German Enigma, but with a 256-element rotor. 
Methods of attack on such machines are known, but not widely; more¬ 
over the amount of work required is likely to be large. 

The transformation of a key into the internal settings of the machine is 
deliberately designed to be expensive, i.e., to take a substantial frac¬ 
tion of a second to compute. However, if keys are restricted to (say) 
three lower-case letters, then encrypted files can be read by expending 
only a substantial fraction of five minutes of machine time. 

If the key is an argument to the crypt command, it is potentially visi¬ 
ble to users executing ps(C) or a derivative. To minimize this possi¬ 
bility, crypt takes care to destroy any record of the key immediately 
upon entry. The choice of keys and key security are the most vulner¬ 
able aspect of crypt . 
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Files 


/dev/tty for typed key 

See Also 


ed(C), edit(C), ex(C), makekey(C), ps(C), stty(C), vi(C) 

Notes 


If two or more files encrypted with the same key are concatenated and 
an attempt is made to decrypt the result, only the contents of the first 
of the original files will be decrypted correctly. 

Distribution of the crypt libraries and utilities is regulated by the U.S. 
Government and are not available to sites outside of the United States 
and its territories. Because we cannot control the destination of the 
software, these utilities are not included in the standard product. If 
your site is within the U.S. or its territories, you can obtain the crypt 
software through your product distributor or reseller. 
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csh _ 

invokes a shell command interpreter with C-like syntax 

Syntax 

csh [ -cefinstvVxX ] [ arg ... ] 

Description 


csh is a command language interpreter. It begins by executing com¬ 
mands from the file .cshrc in the home directory of the invoker. If 
this is a login shell, it also executes commands from the file .login 
there. In the normal case, the shell begins reading commands from the 
terminal, prompting with % . Processing of arguments and the use of 
the shell to process files containing command scripts will be described 
later. 

The shell then repeatedly performs the following actions: a line of 
command input is read and broken into words. This sequence of words 
is placed on the command history list and then parsed. Finally, each 
command in the current line is executed. 

When a login shell terminates, it executes commands from the file 
.logout in the user’s home directory. 

Lexical structure 

The shell splits input lines into words at blanks and tabs with the fol¬ 
lowing exceptions. The characters &, I, <, >, (, ), form separate 
words. If doubled in &&, I I, «, or », these pairs form single words. 
These parser metacharacters may be made part of other words, or their 
special meaning prevented, by preceding them with \ A newline pre¬ 
ceded by a \ is equivalent to a blank. 

In addition, strings enclosed in matched pairs of quotations, ',' or ", 
form parts of a word; metacharacters in these strings, including blanks 
and tabs, do not form separate words. These quotations have seman¬ 
tics to be described subsequently. Within pairs of ' or " characters, a 
newline preceded by a \ gives a true newline character. 

When the shell s input is not a terminal, the character # introduces a 
comment which continues to the end of the input line. It does not 
have this special meaning when preceded by \ and placed inside the 
quotation marks \ ', or ". 
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Commands 

A simple command is a sequence of words, the first of which specifies 
the command to be executed. A simple command or a sequence of 
simple commands separated by I characters forms a pipeline. The out¬ 
put of each command in a pipeline is connected to the input of the 
next. Sequences of pipelines may be separated by and are then exe¬ 
cuted sequentially. A sequence of pipelines may be executed without 
waiting for it to terminate by following it with a &. Such a sequence 
is automatically prevented from being terminated by a hangup signal, 
the nohup command need not be used. 

Any of the above may be placed in parentheses to form a simple com¬ 
mand (which may be a component of a pipeline, etc.) It is also possi¬ 
ble to separate pipelines with I I or && indicating, as in the C lan¬ 
guage, that the second is to be executed only if the first fails or 
succeeds respectively. (See Expressions.) 

Substitutions 

The following sections describe the various transformations the shell 
performs on the input in the order in which they occur. 

History Substitutions 

History substitutions can be used to reintroduce sequences of words 
from previous commands, possibly performing modifications on these 
words. Thus, history substitutions provide a generalization of a redo 
function. 

History substitutions begin with the character ! and may begin any¬ 
where in the input stream if a history substitution is not already in 
progress. The ! may be preceded by a \ to prevent its special meaning; 
a ! is passed unchanged when it is followed by a blank, tab, newline, 
=, or (. History substitutions may also occur when an input line begins 
with *. This special abbreviation will be described later. 

Any input line which contains history substitution is echoed on the 
terminal before it is executed as it could have been entered without 
history substitution. 

Commands input from the terminal which consist of one or more 
words are saved on the history list, the size of which is controlled by 
the history variable. The previous command is always retained. Com¬ 
mands are numbered sequentially from 1. 
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For example, enter the command: 
history 

Now, consider the following output from the history command: 

9 write michael 

10 ex write.c 

11 cat oldwrite.c 

12 diff *write.c 

The commands are shown with their event numbers. It is not usually 
necessary to use event numbers, but the current event number can be 
made part of the prompt by placing a ! in the prompt string. 

With the current event 13 we can refer to previous events by event 
number 111, relatively as in !-2 (referring to the same event), by a pre¬ 
fix of a command word as in !d for event 12 or !w for event 9, or by a 
string contained in a word in the command as in !?mic? also referring 
to event 9. These forms, without further modification, simply reintro¬ 
duce the words of the specified events, each separated by a single 
blank. As a special case !! refers to the previous command; thus !! 
alone is essentially a redo. The form !# references the current com¬ 
mand (the one being entered). It allows a word to be selected from 
further left in the line, to avoid retyping a long name, as in !#:1. 

To select words from an event, we can follow the event specification 
by a : and a designator for the desired words. The words of an input 
line are numbered from 0, the first (usually command) word being 0, 
the second word (first argument) being 1, and so on. The basic word 
designators are: 

0 First (command) word 

n nth argument 

First argument, i.e. 1 

$ Last argument 

% Word matched by (immediately preceding) ?j ? search 


*-y 

Range of words 
-y Abbreviates 0-y 

* Abbreviates ~-$, or nothing if only 1 word in event 
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x * Abbreviates x -$ 
x - Like x * but omitting word $ 

The : separating the event specification from the word designator can 
be omitted if the argument selector begins with a ", $, *, - or %. After 
the optional word designator, a sequence of modifiers can be placed, 
each preceded by a The following modifiers are defined: 

h Removes a trailing pathname component 

r Removes a trailing .xxx component 

s Mr I 

Substitutes / for r 

t Removes all leading pathname components 

& Repeats the previous substitution 

g Applies the change globally, prefixing the above 

p Prints the new command but does not execute it 

q Quotes the substituted words, preventing substitutions 

x Like q, but breaks into words at blanks, tabs, and newlines 

Unless preceded by a g, the modification is applied only to the first 
modifiable word. In any case it is an error for no word to be applica¬ 
ble. 

The left sides of substitutions are not regular expressions in the sense 
of the editors, but rather strings. Any character may be used as the de¬ 
limiter in place of /; a \ quotes the delimiter within the / and r strings. 
The character & in the right side is replaced by the text from the left. 
A \ quotes & also. A null / uses the previous string either from a / or 
from a contextual scan string s in !?s?. The trailing delimiter in the 
substitution may be omitted if a newline follows immediately as may 
the trailing ? in a contextual scan. 

A history reference may be given without an event specification, e.g., 
!$. In this case the reference is to the previous command unless a pre¬ 
vious history reference occurred on the same line in which case this 
form repeats the previous reference. Thus !?foo?"!$ gives the first and 
last arguments from the command matching ?foo?. 

A special abbreviation of a history reference occurs when the first 
nonblank character of an input line is a ". This is equivalent to !:s", 
providing a convenient shorthand for substitutions on the text of the 
previous line. Thus "lb"lib fixes the spelling of lib in the previous 
command. Finally, a history substitution may be surrounded with { 
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and } if necessary to insulate it from the characters that follow. Thus, 
after Is -Id paul we might do ! {1} a to do Is -Id ~paula, while !la would 
look for a command starting la. 

Quotations With 'and " 

The quotation of strings by ' and " can be used to prevent all or some 
of the remaining substitutions. Strings enclosed in ' are prevented any 
further interpretation. Variable and command expansion occurs in 
strings enclosed in". 

In both cases, the resulting text becomes (all or part of) a single word; 
only in one special case (see Command Substitution below) does a " 
quoted string yield parts of more than one word; ' quoted strings never 
do. 


Alias Substitution 

The shell maintains a list of aliases which can be established, dis¬ 
played and modified by the alias and unalias commands. After a com¬ 
mand line is scanned, it is parsed into distinct commands and the first 
word of each command, left-to-right, is checked to see if it has an 
alias. If it does, then the text which is the alias for that command is 
reread with the history mechanism available as though that command 
were the previous input line. The resulting words replace the com¬ 
mand and argument list. If no reference is made to the history list, 
then the argument list is left unchanged. 

Thus if the alias for Is is “Is -1” the command “Is /usr” would map to 
“Is -1 /usr”. Similarly if the alias for “lookup” was “grep \T 
/etc/passwd” then “lookup bill” would map to “grep bill 
/etc/passwd”. 

If an alias is found, the word transformation of the input text is per¬ 
formed and the aliasing process begins again on the reformed input 
line. Looping is prevented if the first word of the new text is the same 
as the old by flagging it to prevent further aliasing. Other loops are 
detected and cause an error. 

Note that the mechanism allows aliases to introduce parser metasyn¬ 
tax. Thus we can alias print “ pr\l* I lpr'” to make a command that 
paginates its arguments to the lineprinter. 

There are four csh aliases distributed. These are pushd, popd, swapd, 
and flipd. These aliases maintain a directory stack. 

pushd dir 

Pushes the current directory onto the top of the directory stack, 
then changes to the directory dir. 
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popd 


Changes to the directory at the top of the stack, then removes 
(pops) the top directory from the stack, and announces the current 
directory. 


swapd 

Swaps the top two directories on the stack. The directory on the 
top becomes the second to the top, and the second to the top direc¬ 
tory becomes the top directory. 


Flips between two directories, the current directory and the top 
directory on the stack. If you are currently in dirl,and dir2 is on 
the top of the stack, when flipd is invoked, you change to dir2 and 
dirl is replaced as the top directory on the stack. When flipd is 
again invoked, you change to dirl and dir2 is again the top direc¬ 
tory on the stack. 


Variable Substitution 

The shell maintains a set of variables, each of which has a list of zero 
or more words as its value. Some of these variables are set by the 
shell or referred to by it. For instance, the argv variable is an image of 
the shell’s argument list, and words of this variable’s value are 
referred to in special ways. 

The values of variables may be displayed and changed by using the set 
and unset commands. Of the variables referred to by the shell a num¬ 
ber are toggles; the shell does not care what their value is, only 
whether they are set or not. For instance, the verbose variable is a tog¬ 
gle which causes command input to be echoed. The setting of this 
variable results from the -v command line option. 

Other operations treat variables numerically. The at-sign (@) com¬ 
mand permits numeric calculations to be performed and the result 
assigned to a variable. However, variable values are always 
represented as (zero or more) strings. For the purposes of numeric 
operations, the null string is considered to be zero, and the second and 
subsequent words of multiword values are ignored. 

After the input line is aliased and parsed, and before each command is 
executed, variable substitution is performed, keyed by dollar sign ($) 
characters. This expansion can be prevented by preceding the dollar 
sign with a backslash (\) except within double quotation marks ( ) 
where it always occurs, and within single quotation marks ( ) where it 
never occurs. Strings quoted by back quotation marks (') are inter¬ 
preted later (see Command substitution below) so dollar sign substitu¬ 
tion does not occur there until later, if at all. A dollar sign is passed 
unchanged if followed by a blank, tab, or end-of-line. 
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Input and output redirections are recognized before variable expan¬ 
sion, and are expanded separately. Otherwise, the command name and 
entire argument list are expanded together. It is thus possible for the 
first (command) word to generate more than one word, the first of 
which becomes the command name, and the rest of which become 
arguments. 

Unless enclosed in double quotation marks or given the :q modifier, 
the results of variable substitution may eventually be subject to com¬ 
mand and filename substitution. Within double quotation marks ("), a 
variable whose value consists of multiple words expands to a portion 
of a single word, with the words of the variable’s value separated by 
blanks. When the :q modifier is applied to a substitution, the variable 
expands to multiple words with each word separated by a blank and 
quoted to prevent later command or filename substitution. 

The following sequences are provided for introducing variable values 
into the shell input. Except as noted, it is an error to reference a vari¬ 
able which is not set. 

$name 

${name} 

Are replaced by the words of the value of variable name , each 
separated by a blank. Braces insulate name from following 
characters which would otherwise be part of it. Shell variables 
have names consisting of up to 20 letters, digits, and under¬ 
scores. 

If name is not a shell variable, but is set in the environment, then that 
value is returned (but: modifiers and the other forms given below are 
not available in this case). 

$name[selector] 

${name[selector]} 

May be used to select only some of the words from the value of 
name. The selector is subjected to $ substitution and may con¬ 
sist of a single number or two numbers separated by a The 
first word of a variables value is numbered 1. If the first number 
of a range is omitted it defaults to 1. If the last member of a 
range is omitted it defaults to $#name. The selector * selects all 
words. It is not an error for a range to be empty if the second 
argument is omitted or in range. 

$#name 

${#name} 

Gives the number of words in the variable. This is useful for 
later use in a [selector]. 

$0 Substitutes the name of the file from which command input is being 
read. An error occurs if the name is not known. 
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$number 
${ number} 

Equivalent to $argv[number]. 

$* Equivalent to $argv[*]. 

The modifiers :h, :t, :r, :q and :x may be applied to the substitutions 
above as may :gh, :gt and :gr. If braces { } appear in the command 
form then the modifiers must appear within the braces. Only one : 
modifier is allowed on each $ expansion. 

The following substitutions may not be modified with : modifiers. 


$?name 

${?name} 

Substitutes the string 1 if name is set, 0 if it is not. 

$?0 Substitutes 1 if the current input filename is known, 0 if it is not. 

$$ Substitutes the (decimal) process number of the (parent) shell. 
Command and Filename Substitution 

Command and filename substitution are applied selectively to the 
arguments of built-in commands. This means that portions of expres¬ 
sions which are not evaluated are not subjected to these expansions. 
For commands which are not internal to the shell, the command name 
is substituted separately from the argument list. This occurs very late, 
after input-output redirection is performed, and in a child of the main 
shell. 

Command Substitution 

Command substitution is indicated by a command enclosed in back 
quotation marks. The output from such a command is normally bro¬ 
ken into separate words at blanks, tabs and newlines, with null words 
being discarded. This text then replaces the original string. Within 
double quotation marks, only newlines force new words; blanks and 
tabs are preserved. 

In any case, the single final newline does not force a new word. Note 
that it is possible for a command substitution to yield only part of a 
word, even if the command outputs a complete line. 


Filename Substitution 

If a word contains any of the characters *, ?, ( or { or begins with the 
character ", then that word is a candidate for filename substitution, 
also known as globbing. This word is then regarded as a pattern, and 
is replaced with an alphabetically sorted list of filenames which match 
the pattern. In a fist of words specifying filename substitution it is an 


March 15,1989 


CSH-8 





CSH(C) 


CSH(C) 


error for no pattern to match an existing filename, but it is not required 
tor each pattern to match. Only the metacharacters *, ?, and [ imply 

pattern matching. The characters ~ and { are more akin to abbrevia¬ 
tions. 

in matching filenames, the character . at the beginning of a filename or 
immediately following a /, as well as the character / must be matched 
explicitly. The character * matches any string of characters, including 
the null string. The character ? matches any single character. The 
sequence within square brackets [] matches any one of the characters 
enclosed. Within square brackets [], a pair of characters separated by 
- matches any character lexically between the two. 


The character at the beginning of a filename is used to refer to home 
directories. Standing alone, it expands to the invoker’s home directory 
contained in the variable HOME. When followed by a name consist- 
mg of letters, digits and - characters the shell searches for a user with 
that name and substitutes their home directory; thus Teen might 
expand to /usr/ken and ~ken/chmach to /usr/ken/chmach. If the charac¬ 
ter is followed by a character other than a letter or /, or if it does not 
appear at the beginning of a word, it is left unchanged. 

The metanotation a{b,c,d}e is a shorthand for abe ace ade. Left to 
right order is preserved, with results of matches being sorted 
separately at a low level to preserve this order. Thus 
source/s l/{ oldls. Is }.c expands to /usr/source/sl/oldls.c 

/usr/source/s 1/ls.c, whether or not these files exist, assuming that the 
home directory for source is /usr/source. Similarly ../{memo,*box} 
might expand to ..Anemo ../box ../mbox. (Note that memo was not 
sorted with the results of matching *box.) As a special case {, } and 
{j are passed unchanged. This construct can be nested. 


Spelling Checker 

If the local variable cdspell has been set, the shell checks spelling 
whenever you use cd to change directories. For example, if you 
change to a different directory using cd and misspell the directory 
name, the shell responds with an alternative spelling of an existing 
directory. Enter “y” and press RETURN (or just press RETURN) to 
change to the offered directory. If the offered spelling is incorrect, 
enter n”, then retype the command line. In this example the csh(C) 
response is boldfaced: 


% cd /usr/spol/uucp 

/usr/spool/uucp? y 
ok 
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Input! Output 

The standard input and standard output of a command may be 

redirected with the following syntax: 

< name , , _ 

Opens file name (after variable, command and filename expan¬ 
sion) as the standard input. 

« w0 ^ ads ^ sheU input up t0 a line which is identical to word . 
Word is not subjected to variable, filename or command substi¬ 
tution, and each input line is compared to word before any sub¬ 
stitutions are done on this input line. Unless a quoting 
backslash, double, or single quotation mark, or a back quotation 
mark appears in word , variable and command substitution is 
performed on the intervening lines, allowing \ to quote $, \ and . 
Commands which are substituted have all blanks, tabs, and new¬ 
lines preserved, except for the final newline which is dropped. 
The resulting text is placed in an anonymous temporary file 
which is given to the command as standard input. 


>name 
>! name 
>& name 

>&! name T _ . a + 

The file name is used as standard output. If the hie does not 

exist, then it is created; if the file exists, it is overwritten. 

If the variable noclobber is set, then an error results if the file 
already exists or if it is not a character special file (e.g., a termi¬ 
nal or /dev/null). This helps prevent accidental destruction of 
files. In this case, the ! forms can be used to suppress this check. 

The forms involving & route the diagnostic output into the 
specified file as well as the standard output. Name is expanded 
in the same way as < input filenames are. 

» name 
»& name 
»! name 

»&! name t . , .. 

Uses file name as standard output like > but places output at the 
end of the file. If the variable noclobber is set, then it is an error 
for the file not to exist unless one of the ! forms is given. Other¬ 
wise similar to >. 

If a command is run in the background (followed by &) then the 
default standard input for the command is the empty file /dev/null. 
Otherwise, the command receives the input and output parameters 
from its parent shell. Thus, unlike some previous shells, commands 
run from a file of shell commands have no access to the text of the 
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commands by default; rather they receive the original standard input 
of the shell. The « mechanism should be used to present inline data. 
This permits shell command scripts to function as components of pipe¬ 
lines and allows the shell to block read its input. 

Diagnostic output may be directed through a pipe with the standard 
output. Simply use the form I & rather than just I. 

Expressions 

A number of the built-in commands (to be described later) take 
expressions, in which the operators are similar to those of C, with the 
same precedence. These expressions appear in the @, exit, if, and 
while commands. The following operators are available: 

I I && I ~ &==!=<=>=<> « » 

+ - * / % ! ~ ( ) 

Here the precedence increases to the right, == and !=, <=, >=, <, and 
>, « and », + and -, * / and % being, in groups, at the same level. 
The == and != operators compare their arguments as strings, all others 
operate on numbers. Strings which begin with 0 are considered octal 
numbers. Null or missing arguments are considered 0. The result of 
all expressions are strings, which represent decimal numbers. It is 
important to note that no two components of an expression can appear 
in the same word unless a word is adjacent to components of expres¬ 
sions which are syntactically significant to the parser (&!<>()), it 
should be surrounded by spaces. 

Also available in expressions as primitive operands are command exe¬ 
cutions enclosed in { and } and file enquiries of the form -/ name 
where / is one of: 

r Read access 

w Write access 

x Execute access 
e Existence 

o Ownership 

z Zero size 

f Plain file 

d Directory 

Command and filename expansion is applied to the specified name, 
then the result is tested to see if it has the specified relationship to the 
real user. If the file does not exist or is inaccessible then all enquiries 
return false, i.e. 0. Command executions succeed, returning true, i.e. 
1, if the command exits with status 0, otherwise they fail, returning 
false, i.e. 0. 

If more detailed status information is required then the command 
should be executed outside of an expression and the variable status 
examined. 
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Control Flow 

The shell contains a number of commands which can be used to regu¬ 
late the flow of control in command files (shell scripts) and (in limited 
but useful ways) from terminal input. Due to the implementation, 
some restrictions are placed on the word placement for the for each, 
switch, and while statements, as well as the if-then-else form of the if 
statement. Please pay careful attention to these restrictions in the 
descriptions in the next section. 

If the shell’s input is not seekable, the shell buffers up input whenever 
a loop is being read and performs seeks in this internal buffer to 
accomplish the rereading implied by the loop. (To the extent that this 
allows, backward goto commands will succeed on nonseekable 
inputs.) 

Built-In Commands 

Built-in commands are executed within the shell. If a built-in com¬ 
mand occurs as any component of a pipeline except the last, then it is 
executed in a subshell. 

alias 

alias name 
alias name wordlist 

The first form prints all aliases. The second form prints the alias 
for name. The final form assigns the specified wordlist as the 
alias of name; wordlist is command and filename substitution is 
applied to wordlist. Name is not allowed to be alias or unalias 

break 

Causes execution to resume after the end of the nearest enclos¬ 
ing foreach or while statement. The remaining commands on 
the current line are executed. Multilevel breaks are thus possi¬ 
ble by writing them all on one line. 

breaksw 

Causes a break from a switch, resuming after the endsw. 
case label: 

This is part of the switch statement discussed below. 


cd 

cd name 

chdir 

chdir name 

Changes the shell’s working directory to directory name. If no 
argument is given, it then changes to the home directory of the 
user. If name is not found as a subdirectory of the current direc¬ 
tory (and does not begin with /,./, or../), then each component of 
the variable cdpath is checked to see if it has a subdirectory 
name. Finally, if all else fails but name is a shell variable 
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whose value begins with /, then this is tried to see if it is a direc¬ 
tory. 

If cdspell has been set, the shell runs a spelling check as follows. If 
me shell is reading its commands from a terminal, and the specified 
directory does not exist (or some component cannot be searched), 
spelling correction is applied to each component of directory in a 
search for the correct’ ’ name. The shell then asks whether or not to 
try and change the directory to the corrected directory name; an 
answer of n means “no,” and anything else is taken as “yes.” 

continue 

Continues execution of the nearest enclosing while ox for each. 
The rest of the commands on the current line are executed. 

default: 

Labels the default case in a switch statement. The default 
should come after all case labels. 

echo wordlist 

The specified words are written to the shell’s standard output. A 
Nc causes the echo to complete without printing a newline. A \n 
in wordlist causes a newline to be printed. Otherwise the words 
are echoed, separated by spaces. 

else 

end 

endif 

endsw 

See the description of the foreach, if, switch, and while state- 
ments below. 

exec command 

The specified command is executed in place of the current shell. 


exit(expr) 

The shell exits either with the value of the status variable (first 
form) or with the value of the specified expr (second form). 

foreach name (wordlist) 

end 

The variable name is successively set to each member of 
wordlist and the sequence of commands between this command 
and the matching end are executed. (Both 
foreach namef wordlist) and end must appear alone on separate 
lmes.) 

The built-in command continue may be used to continue the 
loop prematurely and the built-in command break to terminate it 
prematurely. When this command is read from the terminal, the 
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contents of the loop are read by prompting with ? until end is 
typed before any statements in the loop are executed. 

globwordlist , t , r 

Like echo but no \ escapes are recognized and words are delim¬ 
ited by null characters in the output. Useful for programs which 
wish to use the shell to apply filename expansion to a list of 
words. 

goto word , 

Filename and command expansion is applied to the specmed 
word to yield a string of the form label:. The shell rewinds its 
input as much as possible and searches for a line of the form 
label: possibly preceded by blanks or tabs. Execution continues 
after the specified line. 

history 

Displays the history event list. 

if (expr) command . . t 

If the specified expression evaluates true, then the single com¬ 
mand with arguments is executed. Variable substitution on 
command happens early, at the same time it does for the rest of 
the if command. Command must be a simple command, not a 
pipeline, a command list, or a parenthesized command list. 
Input/output redirection occurs even if expr is false, and com- 
mand is not executed. 

if (expr) then 

else if (expr2) then 

else 


endif 


If the specified expr is true then the commands before the first 
else are executed; else if expr2 is true then the commands after 
the second then and before the second else are executed, etc. 
Any number of else-if pairs are possible; only one endif is 
needed. The else part is likewise optional. (The words else and 
endif must appear at the beginning of input lines; the if (expr) 
then must appear alone on its input line or after an else.) 


logout 


Terminates a login shell. The only way to log out if ignoreeof is 
set. 
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nice 

nice +number 
nice command 
nice +number command 

The first form sets the nice for this shell to 4. By default, com¬ 
mands run under C-Shell have a “nice value” of 0. The second 
form sets the nice to the given number. The final two forms run 
command at priority 4 and number respectively. The super-user 
may specify negative niceness by using “nice -number....” The 
command is always executed in a subshell, and the restrictions 
placed on commands in simple if statements apply. 

nohup 

nohup command 

The first form can be used in shell scripts to cause hangups to be 
ignored for the remainder of the script. The second form causes 
the specified command to be run with hangups ignored. Unless 
the shell is running in the background, nohup has no effect. All 
processes running in the background with & are automatically 
nohupe d. 

onintr 
onintr - 
onintr label 

Controls the action of the shell on interrupts. The first form 
restores the default action of the shell on interrupts which is to 
terminate shell scripts or to return to the terminal command 
input level. The second form, onintr, causes all interrupts to be 
ignored. The final form causes the shell to execute a goto label 
when an interrupt is received or a child process terminates 
because it was interrupted. 

In any case, if the shell is running in the background, interrupts 
are ignored whether any form of onintr is present or not. 

rehash 

Causes the internal hash table of the contents of the directories 
in the path variable to be recomputed. This is needed if new 
commands are added to directories in the path while you are 
logged in. 

repeat count command 

The specified command, which is subject to the same restric¬ 
tions as the command in the simple if statement above, is exe¬ 
cuted count times. I/O redirection occurs exactly once, even if 
count is 0. 


set 

set name 
set name=word 
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set name [index]=word 

set name=(wordlist) „ , „ 

The first form of the command shows the value of all shell vari¬ 
ables. Variables which have other than a single word as value 
print as a parenthesized word list. The second form sets name to 
the null string. The third form sets name to the single word. The 
fourth form sets the indexth component of name to word; this 
component must already exist. The final form sets name to the 
list of words in wordlist. Command and filename expansion is 
applied in all cases. 

These arguments may be repeated to set multiple values in a 
single set command. Note however, that variable expansion 
happens for all arguments before any setting occurs. 

setenv name value 

Sets the value of the environment variable name to be value, 
which must be a single string. Two useful environment vari¬ 
ables are TERM, the type of your terminal and SHELL, the shell 
you are using. 


shift 

shift variable ... . ...... 

In the first form, the members of argv are shifted to the lett, dis¬ 
carding argv[l ]. It is an error for argv not to be set or to have 
less than one word as a value. The second form performs the 
same function on the specified variable. 

source name 

The shell reads commands from name. Source commands may 
be nested, but if they are nested too deeply, the shell may run 
out of file descriptors. An error in a source at any level ter¬ 
minates all nested source commands, including the csh process 
from which source was called. If source is called from the login 
shell, it is logged out. Input during source commands is never 
placed on the history list. 

switch (string) 
case strl: 


breaksw 

default: 

breaksw 

cndsw 

Command and filename substitution is applied to string. The 
each case label is successively matched against the result. Van- 
able expansion is also applied to the case labels, so the file 
metacharacters *, ?, and [...] can be used. If none of the labels 
match before a default label is found, then the execution begins 
after the default label. Each case label and the default label 
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must appear at the beginning of a line. The command breaksw 
causes execution to continue after the endsw. Otherwise control 
may fall through case labels and default labels, as in C. If no 
label matches and there is no default, execution continues after 
the endsw. 


time 

time command 

With no argument, a summary of CPU time used by this shell 
and its children is printed. If arguments are given, the specified 
simple command is timed and a time summary as described 
under the time variable is printed. If necessary, an extra shell is 
created to print the time statistic when the command completes. 
command has the same restrictions as the simple if statement 
described above. 

umask 
umask value 

The file creation mask is displayed (no arguments) or set to the 
specified value (one argument). The mask is given in octal. 
Common values for the mask are 002 giving all access to the 
group and read and execute access to others, or 022 giving read 
and execute access to users in the group and all other users. 

unalias pattern 

All aliases whose names match the specified pattern are dis¬ 
carded. Thus, all aliases are removed by unalias *. It is not an 
error for nothing to be unaliased. 

unhash 

Use of the internal hash table to speed location of executed pro¬ 
grams is disabled. 

unset pattern 

All variables whose names match the specified pattern are 
removed. Thus, all variables are removed by unset *; this has 
noticeably distasteful side-effects. It is not an error for nothing 
to be unset. 


wait 

All child processes are waited for. If the shell is interactive, 
then an interrupt can disrupt the wait, at which time the shell 
prints names and process numbers of all children known to be 
outstanding. 

while (expr) 

end 

While the specified expression evaluates nonzero, the com¬ 
mands between the while and the matching end are evaluated. 
Break and continue may be used to terminate or continue the 
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loop prematurely. (The while (expr) and end must appear alone 
on their input lines.) Prompting occurs here the first time 
through the loop as for the for each statement if the input is a ter¬ 
minal. 


name = expr 
@ name[index] = expr 

The first form prints the values of all the shell variables. The 
second form sets the specified name to the value of expr . If the 
expression contains <, >, & or I then at least this part of the 
expression must be placed within (). The third form assigns the 
value of expr to the indexXh argument of name . Both name and 
its index th component must already exist. 


The operators *=, +=, etc. are available as in C. The space 
separating the name from the assignment operator is optional. 
Spaces are mandatory in separating components of expr which 
would otherwise be single words. The space between @ and 
name is also mandatory. 


Special postfix ++ and - operators increment and decrement 
name respectively, i.e. @ i++. 


Predefined Variables 

The following variables have special meaning to the shell. Of these, 
argv, child , home, path, prompt , shell and status are always set by the 
shell. Except for child and status this setting occurs only at initializa¬ 
tion; these variables will not be modified unless done explicitly by the 
user. 

The shell copies the environment variable PATH into the variable 
path , and copies the value back into the environment whenever path is 
set. Thus it is not necessary to worry about its setting other than in the 
file .cshrc since inferior csh processes will import the definition or 
path from the environment. 


arg v Set to the arguments to the shell, it is from this vari¬ 

able that positional parameters are substituted, i.e., 
$1 is replaced by $argv[l], etc. argv[0] is not 
defined, but $0 is. 

cdpath Gives a list of alternate directories searched to find 

subdirectories in cd commands. 

child The process number of the last command forked 

with &. This variable is unset when this process 
terminates. 
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echo 


histchars 


history 


home 


ignoreeof 


mail 


noclobber 
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Set when the -x command line option is given. 
Causes each command and its arguments to be 
echoed just before it is executed. For nonbuilt-in 
commands all expansions occur before echoing. 
Built-in commands are echoed before command and 
filename substitution, since these substitutions are 
then done selectively. 

Can be assigned a two-character string. The first 
character is used as a history character in place of!, 
the second character is used in place of the * substi¬ 
tution mechanism. For example, set histchars= n ,;" 
will cause the history characters to be comma and 
semicolon. 

Can be given a numeric value to control the size of 
the history list. Any command which has been 
referenced in this many events will not be dis¬ 
carded. A history that is too large may run the shell 
out of memory. The last executed command is 
always saved on the history list. 

The home directory of the invoker, initialized from 
the environment. The filename expansion of ~ 
refers to this variable. 

If set, the shell ignores end-of-file from input de¬ 
vices that are terminals. This prevents a shell from 
accidentally being terminated by pressing Ctrl-D. 

The files where the shell checks for mail. This 
check is executed after each command completion. 
The shell responds with, “You have new mail” if 
the file exists with an access time not greater than 
its modify time. 

If the first word of the value of mail is numeric, it 
specifies a different mail checking interval: in 
seconds, rather than the default, which is 10 
minutes. 

If multiple mail files are specified, then the shell 
responds with “New mail in name ”, when there is 
mail in the file name. 

As described in the section Input!Output, restric¬ 
tions are placed on output redirection to insure that 
files are not accidentally destroyed, and that » 
redirections refer to existing files. 
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noglob 


nonomatch 


path 


prompt 


shell 


status 


If set, filename expansion is inhibited. This is most 
useful in shell scripts which are not dealing with 
filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 

If set, it is not an error for a filename expansion to 
not match any existing files; rather, the primitive 
pattern is returned. It is still an error for the primi¬ 
tive pattern to be malformed, i.e., echo [ still gives 
an error. 

Each word of the path variable specifies a directory 
in which commands are to be sought for execution. 
A null word specifies the current directory. If there 
is no path variable, then only full pathnames will 
execute. The usual search path is /bin, /usr/bin, and 
., but this may vary from system to system. For the 
super-user, the default search path is /etc, /bin and 
/usr/bin. A shell which is given neither the -c nor 
the -t option will normally hash the contents of the 
directories in the path variable after reading .cshrc, 
and each time the path variable is reset. If new 
commands are added to these directories while the 
shell is active, it may be necessary to give the 
rehash command, or the commands may not be 
found. 

The string which is printed before reading each 
command from an interactive terminal input. If a ! 
appears in the string, it will be replaced by the 
current event number unless a preceding \ is given. 
Default is % , or # for the super-user. 

The file in which the shell resides. This is used in 
forking shells to interpret files which have execute 
bits set, but which are not executable by the system. 
(See the description of Nonbuilt-In Command Exe¬ 
cution below.) Initialized to the home of the shell. 

The status returned by the last command. If it ter¬ 
minated abnormally, then 0200 is added to the 
status. Built-in commands which fail return exit 
status 1, otherwise these commands set status to 0. 
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time 


verbose 


Controls automatic timing of commands. If set, 
then any command which takes more than this 
many cpu seconds will cause a line to be sent to the 
screen displaying user time, system time, real time, 
and a utilization percentage which is the ratio of 
user plus system times to real time. 

Set by the -v command line option, causes the 
words of each command to be printed after history 
substitution. 


Nonbuilt-In Command Execution 

When a command to be executed is found to not be a built-in com¬ 
mand, the shell attempts to execute the command via exec (S). Each 
word in the variable path names a directory from which the shell will 
attempt to execute the command. If it is given neither a -c nor a -t 
option, the shell will hash the names in these directories into an inter- 
“altable so that it will only try an exec in a directory if there is a pos¬ 
sibility that the command resides there. This greatly speeds command 
location when a large number of directories are present in the search 
path. If this mechanism has been turned off (via unhash), or if the 
shell was given a -c or -t argument, and for each directory component 
or path which does not begin with a /, the shell concatenates each 
directory component of path with the given command name to form a 
pathname of a file which it then attempts to execute. 

Parenthesized commands are always executed in a subshell. Thus 

(cd ; pwd); pwd 


prints the home directory; leaving you where you were and printing 
the name of the current directory, while 

cd; pwd 

leaves you in the home directory. Parenthesized commands are 
always executed in a subshell. Thus 

(cd; pwd); pwd 

while ^ h ° me direCt0ry but leaves you ** the original directory, 


cd; pwd 

moves you to the home directory. 

If the file has execute permissions but is not an executable binary to 
the system, then it is assumed to be a file containing shell commands 
and a new shell is spawned to read it. 
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If there is an alias for shell then the words of the alias are prepended 
to the argument list to form the shell command. The first word of the 
alias should be the full pathname of the shell (e.g. $shell). Note that 
this is a special, late occurring, case of alias substitution, and only 
allows words to be prepended to the argument list without 
modification. 

Argument List Processing 

If argument 0 to the shell is - then this is a login shell. The flag argu¬ 
ments are interpreted as follows: 

-c Commands are read from the (single) following argument which 
must be present. Any remaining arguments are placed in argv. 

-e The shell exits if any invoked command terminates abnormally 
or yields a nonzero exit status. 

-f The shell will start faster, because it will neither search for nor 
execute commands from the file .cshrc in the invoker’s home 
directory. 

-i The shell is interactive and prompts for its top-level input, even 
if it appears to not be a terminal. Shells are interactive without 
this option if their input and output are terminals. 

-n Commands are parsed, but not executed. This may aid in syn¬ 
tactic checking of shell scripts. 

-s Command input is taken from the standard input. 

-t A single line of input is read and executed. A \ may be used to 

escape the newline at the end of this line and continue onto 
another line. 

-v Causes the verbose variable to be set, with the effect that com¬ 
mand input is echoed after history substitution. 

-x Causes the echo variable to be set, so that commands are echoed 
immediately before execution. 

_V Causes the verbose variable to be set even before .cshrc is exe¬ 
cuted. 

-X Causes the echo variable to be set even before .cshrc is exe¬ 
cuted. 

After processing the flag arguments, if arguments remain but none of 
the -c, -i, -s, or -t options were given, the first argument is taken as the 
name of a file of commands to be executed. The shell opens this file, 
and saves its name for possible resubstitution by $0. On a typical sys¬ 
tem most shell scripts are written for the standard shell (see sh(C)). 
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The C shell will execute such a standard shell if the first character of 
the script is not a # (i.e. if the script does not start with a comment). 
Remaining arguments initialize the variable argv. 

Signal Handling 


The shell normally ignores quit signals. The interrupt and quit signals 
are ignored for an invoked command if the command is followed by 
&, otherwise the signals have the values which the shell inherited 
from its parent. The shells handling of interrupts can be controlled by 
onintr. By default, login shells catch the terminate signal; otherwise 
this signal is passed on to children from the state in the shell’s parent. 
In no case are interrupts allowed when a login shell is reading the file 
.logout. 


Files 

'/.cshrc 

Read at by each shell at the beginning 
of execution 

/etc/cshrc 

Systemwide default cshrc file if none is present 

'/•login 

Read by login shell, after .cshrc at login 

'/.logout 

Read by login shell, at logout 

/bin/sh 

Shell for scripts not starting with a # 

/tmp/sh* 

Temporary file for « 

/dev/null 

Source of empty file 

/etc/passwd 

Source of home directories for ~name 

Limitations 



Words can be no longer than 512 characters. The number of argu¬ 
ments to a command which involves filename expansion is limited to 
1/6 the number of characters allowed in an argument list, which is 
5120, less the characters in the environment. Also, command substitu¬ 
tions may substitute no more characters than are allowed in an argu¬ 
ment list. 

To detect looping, the shell restricts the number of alias substitutions 
on a single line to 20. 

See Also 


access(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
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a.out(F), environ(M) 

Credit 

This utility was developed at the University of California at Berkeley 
and is used with permission. 

Notes 

Built-in control structure commands like foreach and while cannot be 
used with I, & or 

Commands within loops, prompted for by ?, are not placed in the his¬ 
tory list. 

It is not possible to use the colon (:) modifiers on the output of com¬ 
mand substitutions. 

The C-shell has many built-in commands with the same name and 
functionality as Bourne shell commands. However, the syntax of 
these C-shell and Bourne shell commands often differs. Two examples 
are the nice and echo commands. Be sure to use the correct syntax 
when working with these built-in C-shell commands. 

When a C-shell user logs in, the system reads and executes commands 
in /etc/cshrc before executing commands in the user’s $HOME/.cshrc. 
You can, therefore, modify the C-shell environment for all users on the 
system by editing /etc/cshrc. 

During intervals of heavy system load, pressing the delete key while 
at a C-shell prompt (%) may cause the shell to exit. If csh is the login 
shell, the user is logged out. 

csh attempts to import and export the PATH variable for use with reg¬ 
ular shell scripts. This only works for simple cases, where the PATH 
contains no command characters. 
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csplit _ 

splits files according to context 

Syntax 


csplit [-s] [-k] [-f prefix] file argl [... argn] 

Description 


csplit reads file and separates it into n+1 sections, defined by the 
arguments argl... argn. By default the sections are placed in files 
xxOO ... xx/i (n may not be greater than 99). These sections get the 
following pieces of file: 

00: From the start of file up to (but not including) the line refer¬ 

enced by argl. 

01: From the line referenced by argl up to the line referenced by 

argl. 


n+1: From the line referenced by argn to the end of file. 

The options to csplit are: 

-s csplit normally prints the character counts for each file creat¬ 
ed. If the -s option is present, csplit suppresses the printing 
of all character counts. 

-k csplit normally removes created files if an error occurs. If 
the -k option is present, csplit leaves previously created files 
intact. 

-f prefix If the -f option is used, the created files are named prefixOO 
•.. prefixn. The default is xxOO ... xxn. 

The arguments ( argl ... argn) to csplit can be a combination of the 

following: 

Irexpl A file is to be created for the section from the current line 
down to (but not including) the line containing the regular 
expression rexp. The current line becomes the line contain¬ 
ing rexp. This argument may be followed by an optional + 
or - some number of lines (e.g., /Page/-5). 
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%rexp% This argument is the same as /rexp/, except that no file is 
created for the section. 

Inno 

A file is to be created from the current line down to (but not 
including) Inno. The current line becomes Inno. 

{num} 

Repeat argument. This argument may follow any of the 
above arguments. If it follows a rexp type argument, that 
argument is applied num more times. If it follows Inno , the 
file will be split every Inno lines (num times) from that 
point. 


Enclose all rexp type arguments that contain blanks or other charac¬ 
ters meaningful to the shell in the appropriate quotation marks. Regu- 
lar expressions may not contain embedded newlines, esplit does not 
affect the original file; it is the users responsibility to remove it. 


Examples 

esplit-fcobol file "/procedure division/' 7par5./' '/pari6./' 

This example creates four files, cobolOO ... cobol03. After editing 
the “split’ ’ files, they can be recombined as follows: 

cat cobol0[0-3] > file 

Note that this example overwrites the original file, 
esplit-k file 100 {99} 

This example would split the file at every 100 lines, up to 10,000 lines. 
The -k option causes the created files to be retained if there are less 
than 10,000 lines; however, an error message would still be printed. 

esplit -k prog.c '%main(%' T}/+ 1' {20} 

Assuming that prog.c follows the normal C coding convention of end- 
ing routines with a } at the beginning of the line, this example will 
create a file containing each separate C routine (up to 21) in prog.c. 
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See Also 


CSPLIT (C) 


ed(C), sh(C), regex(S) 

Diagnostics 

Self-explanatory except for: 


arg - out of range 

which means that the given argument did not reference a line between 
the current position and the end of the file. 

Standards Conformance 


csplit is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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Ct__ 

spawn getty to a remote terminal 

Syntax 

ct [ -wn ] [ -xn ] [ -h ] [ -v ] [ -sspeed ] telno ... 


Description 

ct dials the telephone number of a modem that is attached to a termi¬ 
nal, and spawns a getty process to that terminal. Telno is a telephone 
number, with equal signs for secondary dial tones and minus signs for 
delays at appropriate places. The set of legal characters for telno is 0 
thru 9, -, =, *, and #. The maximum length telno is 58 characters. If 
more than one telephone number is specified, ct will try each in suc¬ 
cession until one answers; this is useful for specifying alternate dial¬ 
ing paths. 

ct will try each ACU line listed in the file /usr/lib/uucp/Devices until 
it finds an available line with appropriate attributes or runs out of 
entries. If there are no free lines, ct will ask if it should wait for one, 
and if so, for how many minutes it should wait before it gives up. ct 
will continue to try to open the dialers at one-minute intervals until 
the specified limit is exceeded. This value can also be set on the com¬ 
mand line by specifying the -wn option, where n is the maximum 
number of minutes that ct is to wait for a line. 

The -xn option is used for debugging. It produces a detailed output of 
the program execution on stderr. The debugging level, n, is a single 
digit; -x9 produces the most detailed output. If the -v option is used, 
ct will send a running narrative to the standard error output stream. 

Normally, ct will hang up the current line, so the line can answer the 
incoming call. The -h option will prevent this action. The -h option 
will also wait for the termination of the specified ct process before 
returning control to the user’s terminal. 

The data rate may be set with the -s option, where speed is expressed 
in baud. The default rate is 1200. 

After the user on the destination terminal logs out, ct prompts, Recon¬ 
nect? If the response does not begin with the letter y, the line will be 
dropped; otherwise, getty will be started again and the login: prompt 
will be printed. 

To log out properly, the user must type control D. 
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Of course, the destination terminal must be attached to a modem that 
can answer the telephone. 

Files 


Aisr/lib/uucp/Devices 
/usr/lib/uucp/LCK. .(tty-device) 
/usr/adm/ctlog 

See Also 


cu(C), login(M), uucp(C), getty(M) 

Notes 


In hangup mode (-h not specified), when a suitable dialer has been 
allocated, ct prompts “Proceed to hang-up?” If the response does not 
begin with the letter y, the program simply exits. If you are logged in 
on a computer through a local terminal and you want to connect a 
remote terminal to the computer, you should use nohup with ct to 
accomplish this: 

nohup ct -h -s speed phone 

After the command is executed, a login prompt is displayed on the 
remote terminal. The user can then log in and work on the computer 
just as on a local terminal. 
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CU __ 

call another UNIX/XENIX system 

Syntax 

CU [ -sspeed] [-lline] [-h] [-t] [-xn] [-ol-el-oe] [-n] telno 
cu [ -s speed ] [ -h ] [ -xn ] [ [ -o I -e I -oe ] -1 line [ dir ] 
cu [ -h ] [ -xn ] [ -o I -e I -oe ] systemname 


Description 

cu calls up another UNIX system, a terminal, or possibly a non-UNIX 
system. It manages an interactive conversation with possible transfers 
of ASCII files. 

cu accepts the following options and arguments: 

-sspeed Specifies the transmission speed (150, 300, 600, 1200, 
2400, 4800, 9600, 19200, 38400). The default value is 
"Any" speed which will depend on the order of the lines 
in the /usr/lib/uucp/Devices file. A speed range can 
also be specified (for example, -sl200-4800). 

-1 Une Specifies a device name to use as the communication 

line. This can be used to override the search that would 
otherwise take place for the first available line having 
the right speed. When the -1 option is used without the 
-s option, the speed of a line is taken from the Devices 
file. When the -1 and -s options are both used together, 
cu will search the Devices file to check if the requested 
speed for the requested line is available. If so, the con¬ 
nection will be made at the requested speed; otherwise 
an error message will be printed and the call will not be 
made. The specified device is generally a directly con¬ 
nected asynchronous line (e.g., /dev/ttyab) in which 
case a telephone number (telno) is not required. The 
specified device need not be in the /dev directory. If 
the specified device is associated with an auto dialer, a 
telephone number must be provided. Use of this option 
with systemname rather than telno will not give the 
desired result (see systemname below). 

_h Emulates local echo, supporting calls to other computer 

systems which expect terminals to be set to half-duplex 
mode. 
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"t Used to dial an ASCII terminal which has been set to 

auto answer. Appropriate mapping of carriage-return to 
carriage-return-line-feed pairs is set. 

■Xfl Causes diagnostic traces to be printed; it produces a 

detailed output of the program execution on stderr. The 
debugging level, n, is a single digit; -x9 is the most 
useful value. 

-n For added security, will prompt the user to provide the 

telephone number to be dialed rather than taking it 
from the command line. 

telno When using an automatic dialer, the argument is the 

telephone number with equal signs for secondary dial 
tone or minus signs placed appropriately for delays of 4 
seconds. 

systemname A UUCP system name may be used rather than a tele¬ 
phone number. In this case, cu will obtain an appropri¬ 
ate direct line or telephone number from 
/usr/lib/uucp/Systems. Note: the systemname option 
should not be used in conjunction with the -1 and -s 
options as cu will connect to the first available line for 
the system name specified, ignoring the requested line 
and speed. 

dir The keyword dir can be used with cu -1 line, in order to 

talk directly to a modem on that line, instead of talking 
to another system via that modem. This can be useful 
when debugging or checking modem operation. Note: 
only users with write access to the Devices file are per¬ 
mitted to use cu -1 line dir. 

In addition, cu uses the following options to determine communica¬ 
tions settings: 

-o If the remote system expects or sends 7-bit with odd parity. 

-e If the remote system expects or sends 7-bit with even parity. 

-oe 

If the remote system expects or sends 7-bit, ignoring parity and 
sends 7-bit with either parity. 

By default, cu expects and sends 8-bit characters without parity. If the 
login prompt received appears to contain incorrect 8-bit characters, or 
a correct login is rejected, use the 7-bit options described above. 

After making the connection, cu runs as two processes: the transmit 
process reads data from the standard input and, except for lines begin¬ 
ning with ", passes it to the remote system; the receive process accepts 
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data from the remote system and, except for lines beginning with ', 
passes it to the standard output. Normally, an automatic DC3/DC1 
protocol is used to control input from the remote so the buffer is not 
overrun. Lines beginning with" have special meanings. 

The transmit process interprets the following user initiated com¬ 
mands: 


**! 

terminate the conversation. 

escape to an interactive shell on the local sys¬ 
tem. 

"land ... 

run cmd on the local system (via sh -c). 

~%cmd ... 

run cmd locally and send its output to the 
remote system. 

%cd 

change the directory on the local system. 
Note: ~!cd will cause the command to be run 
by a sub-shell, probably not what was 
intended. 

~%take from [ to ] 

copy file from (on the remote system) to file 
to on the local system. If to is omitted, the 
from argument is used in both places. 

~%put from [ to ] 

copy file from (on local system) to file to on 
remote system. If to is omitted, the from 
argument is used in both places. 

For both “%take and ~%put commands, as 
each block of the file is transferred, consecu¬ 
tive single digits are printed to the terminal. 

""line 

send the line "line to the remote system. 

"% break 

transmit a BREAK to the remote system 
(which can also be specified as ~%b). 

"% debug 

toggles the -x debugging level between 0 and 
9 (which can also be specified as ~%d). 

"t 

prints the values of the termio structure vari¬ 
ables for the user’s terminal (useful for 
debugging). 

"\ 

prints the values of the termio structure vari¬ 
ables for the remote communication line 
(useful for debugging). 
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% nostop toggles between DC3/DC1 input control pro¬ 

tocol and no input control. This is useful in 
case the remote system is one which does not 
respond properly to the DC3 and DC1 charac¬ 
ters. 

The receive process normally copies data from the remote system to 
its standard output. Internally the program accomplishes this by ini¬ 
tiating an output diversion to a file when a line from the remote begins 
with ". Data from the remote is diverted (or appended, if » is used) 
to file on the local system. The trailing “> marks the end of the diver¬ 
sion. 

The use of ~%put requires stty( C) and cat( C) on the remote side. It 
also requires that the current erase and kill characters on the remote 
system be identical to these current control characters on the local 
system. Backslashes are inserted at appropriate places. 

The use of take requires the existence of echo(S ) and cat( C) on the 
remote system. Also, tabs mode (See stty(C)) should be set on the 
remote system if tabs are to be copied without expansion to spaces. 

When cu is used on systeml to connect to system2 and subsequently 
used on system. 2 tojconnect to system3, commands on system2 can be 
executed by using . Executing a tilde command reminds the user of 
the local system uname. For example, uname can be executed on sys¬ 
tems 1,2, and 3 as follows: 

uname 

system3 

"system 1! uname 
systeml 

~~system2! uname 
system2 

In general, ~ causes the command to be executed on the original ma¬ 
chine, ~ causes the command to be executed on the next machine in 
the chain. 

Examples 


To dial a system whose telephone number is 9 201 555 1212 using 
1200 baud (where dialtone is expected after the 9): 

cu -si200 9=12015551212 

If the speed is not specified, “Any” is the default value. 

To login to a system connected by a direct line: 

cu -1 /dev/ttyXX 
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or 

cu -1 ttyXX 

To dial a system with the specific line and a specific speed: 
cu -si200 -1 ttyXX 

To dial a system using a specific line associated with an auto dialer: 

cu -1 ttyXX 9=12015551212 
To use a system name: 
cu systemname 

To talk directly to an ACU (connect directly with the modem and 
enter modem commands manually): 

cu -IttyXX dir 

Files 

/usr/lib/uucp/Systems 
Aisr/lib/uucp/Devices 
Aisr/lib/uucp/LCK. .(tty-device) 

See Also 

cat(C), ct(C), echo(S), stty(C), uucp(C), uname(C) 

Diagnostics 

Exit code is zero for normal exit, otherwise, one. 
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The cu command does not do any integrity checking on data it 
transfers. Data fields with special cu characters may not be 
transmitted properly. Depending on the interconnection hardware, 
it may be necessary to use a . to terminate the conversion even if 
stty 0 has been used. Non-printing characters are not dependably 
transmitted using either the %put or %take commands, cu 
between an IMBR1 and a penril modem will not return a login 
prompt immediately upon connection. A carriage return will 
return the prompt. 

Notes 


There is an artificial slowing of transmission by cu during the 
%put operation so that loss of data is unlike ly 

Standards Conformance 


cu is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide 13 of January 1987. 
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cut _ 

cuts out selected fields of each line of a file 


Syntax 

cut -c list [ filel file2 ...] 

cut -f list [-d char] [-s] [filel file2 ...] 

Description 

Use cut to cut out columns from a table or fields from each line of a 
file. The fields as specified by list can be fixed length, i.e., character 
positions as on a punched card (-c option), or the length can vary front 
line to line and be marked with a field delimiter character like tub (-1 
option), cut can be used as a filter. If no files are given, the standard 
input is used. 

The meanings of the options are: 

list A comma-separated list of integers (in increasing order), with 
an optional dash (-), indicates ranges, as in the -o option of 
nroff/troff for page ranges; e.g., 1,4,7; 1-3,8; -5,10 (short for 
1-5,10); or 3- (short for third through last field). 

•clist The list following -c (no space) specifies character positions 
(e.g., -cl-72 would keep the first 72 characters of each line). 

-f list The list following -f is a list of fields assumed to be separated 
in the file by a delimiter character (see -d ); e.g., -fl,7 copies 
the first and seventh field only. Lines with no field delimiters 
will be passed through intact (useful for table subheadings), 
unless -s is specified. 

-dchar The character following -d is the field delimiter (-f option 
only). Default is tab. Space or other characters with special 
meaning to the shell must be quoted. 

-s If the -f option is used, -s suppresses lines with no delimiter 
characters. Unless specified, lines with no delimiters will be 
passed through untouched. 

Either the -c or -f option must be specified. 
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Use ^ (C) t0 make horizon tal “cuts” (by context) through a file, or 
paste (C) to put files together horizontally. To reorder col umns i n a 
table, use cut and paste. 

Examples 


cut -d: -fl ,5 /etc/passwd Maps user ID’s to names. 

name=' who am i I cut -fl -d" 

Sets name to current login name. 

See Also 

grep(C), paste(C) 

Diagnostics 


line too long A line can have no more than 511 characters or 
fields. 

bad list for clf option 

Missing -c or -f option or incorrecdy specified list. 
No error occurs if a line has fewer fields than the list 
calls for. 

no fields The list is empty. 

Standards Conformance 


cut is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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date _ 

prints and sets the date 


Syntax 

date [ mmddhhmm[yy] ] [ +format ] 

Description 

If no argument is given, or if the argument begins with +, the current 
date and time are printed as defined by the locale. Otherwise, the 
current date is set. The first mm is the month number, dd is the day 
number in the month; hh is the hour number (24-hour system), the 
second mm is the minute number; yy is the last 2 digits of the year 
number and is optional. For example: 

date 10080045 

sets the date to Oct 8,12:45 AM, if the local language is set to English. 
The current year is the default if no year is mentioned. The system 
operates in GMT. date takes care of the conversion to and from local 
standard and daylight time. 


If the argument begins with +, the output of date is under the control 
of the user. The format for the output is similar to that of the first 
argument to printfi S). All output fields are of fixed size (zero padded 
if necessary). Each field descriptor is preceded by a percent sign (%) 
and will be replaced in the output by its corresponding value. A single 
percent sign is encoded by doubling the percent sign, i.e., by specify¬ 
ing All other characters are copied to the output without 

change. The string is always terminated with a newline character. 

Field Descriptors: 

n Inserts a newline character 

t Inserts a tab character 

m Month of year - 01 to 12 

d Day of month - 01 to 31 

y Last 2 digits of year - 00 to 99 

D Date as mm/dd/yy 
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H Hour-00 to 23 
M Minute - 00 to 59 
S Second - 00 to 59 
T Time as HH:MM:SS 
j Julian date - 001 to 366 
w Day of the week - Sunday = 0 
a Abbreviated weekday - Sun to Sat 
h Abbreviated month - Jan to Dec 
r Time in AM/PM notation 

Example 

The line 

date '+DATE: %m/%d/%y%nTIME: %H:%M:%S' 

generates as output: 

DATE: 08/01/90 
TIME: 14:45:05 

Diagnostics 

no permission You aren’t the super-user and you are trying to 

change the date. 

bad conversion The date set is syntactically incorrect. 

bad format character The field descriptor is not recognizable. 

Standards Conformance 

date is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 


March 15,1989 


DATE-2 







DC (C) 


DC (C) 


dc 

invokes an arbitrary precision calculator 

Syntax 


dc [ file ] 

Description 


dc is an arbitrary precision arithmetic package. Ordinarily it operates 
on decimal integers, but you may specify an input base, output base, 
and a number of fractional digits to be maintained. The overall struc¬ 
ture of dc is a stacking (reverse Polish) calculator. If an argument is 
given, input is taken from that file until its end, then from the standard 
input. The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is 
an unbroken string of the digits 0-9. It may be preceded by an 
underscore (_) to input a negative number. Numbers may con¬ 
tain decimal points. 

+ - / * % A 

The top two values on the stack are added (+), subtracted (-), 
multiplied (*), divided (/), remaindered (%), or exponentiated 
0 ). The two entries are popped off the stack and the result 
pushed on the stack in their place. Any fractional part of an 
exponent is ignored. 

The top of the stack is popped and stored into a register named 
x, where x may be any character. If the s is capitalized, x is 
treated as a stack and the value is pushed on it. 

lx The value in register x is pushed on the stack. The register x is 
not altered. All registers start with zero value. If the 1 is capi¬ 
talized, register x is treated as a stack and its top value is 
popped onto the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains 
unchanged, p interprets the top of the stack as an ASCII string, 
removes it, and prints it. 

f All values on the stack are printed. 
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q Exits the program. If executing a string, the recursion level is 
popped by two. If q is capitalized, the top value on the stack is 
popped and the string execution level is popped by that value. 

x Treats the top element of the stack as a character string and 
executes it as a string of dc commands. 

X Replaces the number on the top of the stack with its scale fac¬ 
tor. 

[... ] Puts the bracketed ASCII string onto the top of the stack. 

<x >x -x 

The top two elements of the stack are popped and compared. 
Register x is evaluated if they obey the stated relation. 

v Replaces the top element on the stack by its square root. Any 
existing fractional part of the argument is taken into account, 
but otherwise the scale factor is ignored. 

! Interprets the rest of the line as a UNIX command. 

c All values on the stack are popped. 

i The top value on the stack is popped and used as the number 
radix for further input. 

I Pushes the input base on the top of the stack. 

o The top value on the stack is popped and used as the number 

radix for further output. 

O Pushes the output base on the top of the stack. 

k The top of the stack is popped, and that value is used as a non¬ 

negative scale factor; the appropriate number of places are 
printed on output, and maintained during multiplication, divi¬ 
sion, and exponentiation. The interaction of scale factor, input 
base, and output base will be reasonable if all are changed 
together. 

z The stack level is pushed onto the stack. 

Z Replaces the number on the top of the stack with its length. 

? A line of input is taken from the input source (usually the ter¬ 
minal) and executed. 

;: Used by be for array operations. 
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Example 


This example prints the first ten values of n!: 

[lal+dsa*plalO>y]sy 

Osal 

lyx 

See Also 


bc(C) 

Diagnostics 


x is unimplemented 

The octal number x corresponds to a character 
that is not implemented as a command 

stack empty 

Not enough elements on the stack to do what 
was asked 

Out of space 

The free list is exhausted (too many digits) 

Out of headers 

Too many numbers being kept around 

Out of pushdown 

Too many items on the stack 

Nesting Depth 

Too many levels of nested execution 

Notes 



be is a preprocessor for dc, providing infix notation and a C-like syn¬ 
tax which implements functions and reasonable control structures for 
programs. For interactive use, be is preferred to dc . 
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dd 


converts and copies a file 

Syntax 


dd [option=value] 

Description 


dd copies the specified input file to the specified output with possible 
conversions. Tlie standard input and output are used by default. The 
input and output block size may be specified to take advantage of raw 
physical I/O. 


Option 

Value 

if -file 

Input filename; standard input is default 

of =file 

Output filename; standard output is default 

ibs=n 

Input block size is n bytes (default is BSIZE block 
size) 

obs =n 

Output block size (default is BSIZE block size) 

bs -n 

Sets both input and output block size, superseding ibs 
and obs. If no conversion is specified, it is particu¬ 
larly efficient since no in-core copy needs to be done 

cbs =n 

Conversion buffer size 

skip =n 

Skips n input records before starting copy 

seek -n 

Seeks n records from beginning of output file before 
copying 

counts 

Copies only n input records 

conv=ascii 

Converts EBCDIC to ASCII 

conv=ebcdic 

Converts ASCII to EBCDIC 

conv=ibm 

Slightly different map of ASCII to EBCDIC 

conv=lcase 

Maps alphabetic characters to lowercase 
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Option 

conv=ucase 

conv=swab 

conv=sync 


Value 

Maps alphabetic characters to uppercase 
Swaps every pair of bytes 
Pads every input record to ibs 


conv=". 

Several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A number 
may end with k, b, or w to specify multiplication by 1024, 512, or 2 
respectively; a pair of numbers may be separated by x to indicate a 
product. 


cbs is used only if ascii or ebcdic conversion is specified. In the 
former case cbs characters are placed into the conversion buffer, con¬ 
verted to ASCII, and trailing blanks trimmed and newline added before 
sending the line to the output. In the latter case ASCII characters are 
read into the conversion buffer, converted to EBCDIC, and blanks 
added to make up an output record of size cbs. 


After completion, dd reports the number of whole and partial input 
and output blocks. 

Examples 


This command reads an EBCDIC tape, blocked ten 80-byte EBCDIC 
card images per record, into the ASCII file outfile: 

dd if=/dev/rmtO of=outfile ibs=800 cbs=80 conv=ascii,lease 

Note the use of raw magtape, dd is especially suited to I/O on raw 
physical devices because it allows reading and writing in arbitrary 
record sizes. 

See Also 


copy(C), cp(C), tar(C) 

Diagnostics 


f+p records in(out) Numbers of full and partial records 

read( written) 
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The ASCII/EBCDIC conversion tables are taken from the 256- 
character standard in the CACM Nov, 1968. The ibm conversion cor¬ 
responds better to certain IBM print train conventions. There is no 
universal solution. 

Newlines are inserted only on conversion to ASCII; padding is done 
only on conversion to EBCDIC. 

When using dd with a raw device, specify the block size as a multiple 
of IK. For example, to use a 9K block size, enter: 

dd if=file of=/dev/rfdO bs=18b 

You could also enter: 

dd if=file of=/dev/rfdO bs=9K 

Standards Conformance 


dd is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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devnm_ 

identifies device name 

Syntax 

/etc/devnm [ names ] 

Description 

devnm identifies the special file associated with the mounted file sys¬ 
tem where the argument name resides. 

This command is most commonly used by the /etc/rc2 scripts to con¬ 
struct a mount table entry for the root device. 

Examples 

Be sure to type full pathnames in this example: 

/etc/devnm /usr 

If /dev/hdl is mounted on /usr, this produces: 
hdl /usr 

Files 


/dev/* Device names 
/etc/rc2 Startup commands 

See Also 

setmnt(ADM) 

Standards Conformance 

devnm is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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report number of free disk blocks 

Syntax 


df [ -t ] [ -f ] [ -v ] [ filesystems ] 

Description 


df prints out the number of free blocks and free inodes available for 
on-line filesystems by examining the counts kept in the super-blocks; 
filesystems may be specified by device name (e.g., /dev/root). If the 
filesystems argument is unspecified, the free space on all of the 
mounted filesystems is sent to the standard output. The list of 
mounted filesystems is given in /etc/mnttab. 

Options include: 

-t Causes total allocated block figures to be reported as well as 
number of free blocks. 

-f Reports only an actual count of the blocks in the free list (free 
inodes are not reported). With this option, df reports on raw de¬ 
vices. 

-v Reports the percent of blocks used as well as the number of 
blocks used and free. 

The -v option can not be used with other ^options. 

Files 


/dev/* 

/etc/mnttab 

See Also 

mount(ADM), fsck(ADM), mnttab(F) 

Notes 

See Notes under mount(ADM). 
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This utility reports sizes in 512 byte blocks, df will report 2 blocks 
less free space, rather than 1 block, since the file uses one system 
block of 1024 bytes. 

The directory /etc/fscmd.d/7YP£ contains programs for each filesys¬ 
tem type, invokes the appropriate binary. 

Authorization 


The behavior of this utility is affected by assignment of the querys- 
pace authorization, which is usually reserved for system administra¬ 
tors. Refer to the “Using a Trusted System” chapter of the User’s 
Guide for more details. 

Standards Conformance 


df is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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diff _ 

compares two text files 

Syntax 

diff [ -belli ] filel file2 

Description 


diff tells what lines must be changed in two files to bring them into 
agreement. If file 1 or file2 is a dash (-), the standard input is used. If 
filel or file2 is a directory, douses the file in that directory that has 
the same name as the file {filel or filel respectively) it is compared to. 
For example: 

diff Itmp dog 

compares the file named dog that is in the Itmp directory, with the file 
dog in the current directory. The normal output contains lines of these 
forms: 

nl a n3,n4 
nl,n2 d n3 
nl,n2 c n3,n4 

These lines resemble ed commands to convert filel into file2 . The 
numbers after the letters pertain to file2 . In fact, by exchanging a for 
d and reading backward, one may ascertain equally how to convert 
filel into filel . As in ed, identical pairs where nl = n2 or n3 = n4 are 
abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the 
first file flagged by <, then all the lines that are affected in the second 
file flagged by >. 

The -b option causes trailing blanks (spaces and tabs) to be ignored 
and other strings of blanks to compare equal. 

The -e option produces a script of a, c and d commands for the editor 
ed, which will recreate file2 from filel . The -f option produces a simi¬ 
lar script, not useful with ed, in the opposite order. In connection with 
-e, the following shell procedure helps maintain multiple versions of a 
file: 


(shift; cat $*; echo 'l,$p') I ed - $1 
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This works by performing a set of editing operations on an original 
ancestral file. This is done by combining the sequence of ed scripts 
given as all command line arguments except the first. These scripts 
are presumed to have been created with diff in the order given on the 
command line. The set of editing operations is then piped as an edit¬ 
ing script to ed where all editing operations are performed on the 
ancestral file given as the first argument on the command line. The 
final version of the file is then printed on the standard output. Only an 
ancestral file ($1) and a chain of version-to-version ed scripts 
($2,$3,...) made by diff need be on hand. 

Except in rare circumstances, diff finds the smallest sufficient set of 
file differences. 

The -h option does a fast, less-rigorous job. It works only when 
changed stretches are short and well separated, but the files can be of 
unlimited length. The -e and -f options cannot be used with the -h 
option. 

Files 


/tmp/d????? 

/usr/lib/diffli (executable used when -h option is specified) 

See Also 


cmp(C), comm(C), ed(C) 

Diagnostics 

Exit status is 0 for no differences, 1 for some differences, 2 for errors. 

Notes 

Editing scripts produced under the -e or -f option do not always work 
correctly on lines consisting of a single period (.). 

Standards Conformance __ 

diff is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 


March 15, 1989 


DIFF-2 











DIFF3 (C) 


DIFF3 (C) 


diff3 _ 

compares three files 

Syntax 

difl3 [ -ex3 ] filel file2 file3 

Description 


diff3 compares three versions of a file, and publishes disagreeing 
ranges of text flagged with these codes: 

==== All three files differ 

====1 Filel is different 

====2 Filel is different 

====3 File3 is different 

The type of change suffered in converting a given range of a given file 
to some other range is indicated in one of these ways: 

f ‘ nl & Text is to be appended after line number nl in 

file/, where / = 1,2, or 3. 

f '.nl ,n2 c Text is to be changed in the range line nl to 

line n2 . If nl = n2, the range may be abbrevi¬ 
ated to nl. 

The original contents of the range follows immediately after a c indi¬ 
cation. When the contents of two files are identical, the contents of 
the lower-numbered file is suppressed. 

Under the -e option, dij}3 publishes a script for the editor ed that will 
incorporate into filel all changes between file2 and file3, i.e., the 
changes that normally would be flagged ==== and ====3. The -x 
option produces a script to incorporate changes flagged with “===”. 
Similarly, the -3 option produces a script to incorporate changes 
flagged with ‘====3”. The following command applies a resulting 
editing script to filel: 

(cat script; echo 'l,$p') I ed - filel 


March 15, 1989 


DIFF3-1 











DIFF3 (C) 


DIFF3 (C) 


Files 

/tmp/d3* 

/usr/lib/difBprog 

See Also 

diff(C) 

Notes 

The -e option does not work properly for lines consisting of a single 
period. 

The input file size limit is 64K bytes. 
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dircmp 


compares directories 


Syntax 


dircmp [ -d ] [ -s ] [ -wn ] dirl dir2 

Description 



dircmp examines dirl and dir2 and generates tabulated information 
about the contents of the directories. Listings of files that are unique 
to each directory are generated in addition to a list that indicates 
whether the files common to both directories have the same contents. 

There are three options available: 

-d Performs a full diff on each pair of like-named files if the 
contents of the files are not identical. 

-s Suppresses output of identical filenames. 

-w« Changes the width of the output line to n characters. The 
default width is 72. 


See Also 


cmp(C), diff(C) 

Standards Conformance 


dircmp is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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dirname__ 

delivers directory part of pathname 

Syntax 

dirname string 

Description 

dirname delivers all but the last component of the pathname in string 
and prints the result on the standard output. If there is only one com¬ 
ponent in the pathname, only a “dot” is printed. It is normally used 
inside substitution marks (") within shell procedures. 

The companion command basename deletes any prefix ending in a 
slash (/) and the suffix (if present in string ) from string, and prints the 
result on the standard output. 

Examples 

The following example sets the shell variable NAME to /usr/src/cmd: 

NAME= V dirname /usr/src/cmd/cat.c v 
This example prints /a/b/c on the standard output: 
dirname /a/b/c/d 

This example prints a “dot” on the standard output: 
dirname file .ext 

This example moves to the location of a file being searched for (lost- 
file): 

cd ‘find . -name lostfile -exec dirname { }:‘ 

See Also 


basename(C), sh(C) 

Standards Conformance 


dirname is conformant with: 

The X/Open Portability Guide II of January 1987. 
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disable _ 

turns off terminals and printers 

Syntax 

disable tty... 

disable [-c][-r [reason]] printers 

Description 


For terminals, this program manipulates the /etc/conf/cf.d/init.base 
file and signals init to disallow logins on a particular terminal. For 
printers, disable stops print requests from being sent to the named 
printer. The following options can be used: 

-c Cancels any requests that are currently prin tin g 

-r [reason] Associates a reason with disabling the printer. The rea¬ 

son applies to all printers listed up to the next -r option. 
If the -r option is not present or the -r option is given 
without a reason, then a default reason is used. Reason 
is reported by lpstat( C). 

Examples 


In this example, a printer named linepr is disabled because of a paper 
jam: 


disable -r"paper jam" linepr 


Files 

/dev/tty* 

/etc/conf/cf.d/init.base 
/usr/spool/lp/* 

See Also 


login(M), enable(C), inittab(F), getty(M), init(M), lp(C), lpstat(C), 
uugetty(ADM) 
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DISABLE (C) 


The behavior of this utility is affected by assignment of the printer- 
stat authorization, which is usually reserved for system administra¬ 
tors. Refer to the “Using a Trusted System” chapter of the User’s 
Guide for more details. 
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diskcp, diskcmp 

copies or compares floppy disks 

Syntax 


diskcp [ -f ] [ -d ] [ -s ] [ -48ds9 ] [ -96ds9 ] [ -96dsl5 ] [ -135ds9 ] [ -135dsl8 ] 
diskcmp [ -d ] [ -s ] [ -48ds9 ] [ -96ds9 ] [ -96dsl5 ] [ -135ds9 ] [ -135dsl8 ] 


Description 


diskcp is used to make an image (exact copy) of a source floppy disk 
on a target floppy disk. On machines with one floppy drive diskcp 
temporarily transfers the image to the hard disk until a “target” 
floppy is inserted into the floppy drive. On machines with two floppy 
dnves diskcp immediately places the image of the source floppy 
directly on the target floppy. 

diskcmp functions similarly to diskcp. It compares the contents of one 
floppy disk with the contents of a second floppy disk using the cmp 
utility. 

The options are: 

-f Format the target floppy disk before the image is copied (diskcp 
only). 

-d The computer has dual floppy drives, diskcp copies the image 
directly onto the target floppy. 

-s Uses sum(C) to compare the contents of the source and target 
floppies; gives an error message if the two do not match. 

-48ds9 

This setting is for low density 48tpi floppies. It is the default set¬ 
ting. 

-96ds9 

This setting is for high density 96tpi floppies. 

-96dsl5 

This setting is for quad density 96tpi floppies. 

-135ds9 

This setting is for high density 135tpi 3.5 inch floppies. 
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-135dsl8 

This setting is for quad density 135tpi 3.5 inch floppies. 

When using the -96ds9 and -96dsl5 options of diskcp without the -f 
option, if the first target disk is unformatted, the program will note it, 
format it and make the copy. If another copy is requested and another 
unformatted target disk inserted, diskcp exits with a “System error.” 
Quit, format the floppy, and reinvoke diskcp to make another copy. 

Examples 

To make a copy of a floppy, place the source floppy in the drive and 
type: 

diskcp 

When diskcp is finished copying to the hard disk, it prompts you to 
insert the target floppy in the drive. If you specify the -f flag when you 
invoke diskcp , the program formats the target floppy. When the copy 
is finished, diskcp asks if you would like to make another copy of the 
same source disk. If you enter ‘n\ it asks if you would like to copy 
another source disk. 

Specify the -d flag on the command line if you have two floppy drives: 
diskcp -d 

Notes 


If diskcp encounters a write error while copying the source image to 
the target disk, it formats the disk and tries to write the source image 
ag ain This happens most often when an unformatted floppy is used 
and the -f flag is not specified. 

Files 

/usr/bin/diskcp 

/usr/bin/diskcmp 

/tmp/disk???? 

See Also 

cmp(C), dd(C), format(C), sum(C) 

Value Added 

diskcmp and diskcp are extensions of AT&T System V provided by the 
Santa Cruz Operation. 


March 15,1989 


DISKCP-2 









DOS (C) 


DOS(C) 


dos: doscat, doscp, dosdir, dosfor- 
mat, dosmkdir, dosls, dosrm, 
dosrmdir_ 

access to and manipulation of DOS files and DOS 
filesystems 

Syntax 


doscat [ -r I -m ] file ... 
doscp [ -r I -m ] filel file2 
doscp [ -r I -m ] file ... directory 
dosdir directory ... 
dosformat [ -fqv ] drive 
dosls directory ... 
dosmkdir directory ... 
dosrm file ... 
dosrmdir directory ... 

Description 


The dos commands provide access to the files and directories on MS- 
DOS disks and on a DOS partition of a hard disk. Note that in order to 
use these commands on a DOS partition of a hard disk, the partition 
must be bootable, although not active. It is also possible to mount and 
access a DOS filesystem while operating from the UNIX partition. 

The dos commands perform the following actions: 

doscat Copies one or more DOS files to the standard output. If 

-r is given, the files are copied without newline conver¬ 
sions. If -m is given, the files are copied with newline 
conversions (see “Conversions” below). 

doscp Copies files between a DOS disk and a UNIX filesystem. 

K filel and file2 are given, filel is copied to file2. If a 
directory is given, one or more files are copied to that 
directory. If -r is given, the files are copied without 
newline conversions. If -m is given, the files are copied 
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with newline conversions (see “Conversions” below). 

dosdir Lists DOS files in the standard DOS style directory for¬ 

mat. 

dosformat Creates a DOS 2.0 formatted diskette. The drive may 
be specified in either DOS drive convention, using the 
default file /etc/default/msdos, or using the UNIX spe¬ 
cial file name, dosformat cannot be used to format a 
hard disk. The -f option suppresses the interactive 
feature. The -q (quiet) option is used to suppress infor¬ 
mation normally displayed during dosformat . The -q 
option does not suppress the interactive feature. The -v 
option prompts the user for a volume label after the 
diskette has been formatted. The maximum size of the 
volume label is 11 characters. 

dosls Lists DOS directories and files in a UNIX format (see 

ls{Q). 

dosrm Removes files from a DOS disk. 

dosmkdir Creates a directory on a DOS disk. 

dosrmdir Deletes directories from a DOS disk. 

The file and directory arguments for DOS files and directories have the 
form: 

device:name 

where device is a UNIX pathname for the special device file contain¬ 
ing the DOS disk, and name is a pathname to a file or directory on the 
DOS disk. The two components are separated by a colon (:). For 
example, the argument: 

/dev/fdO:/src/file.asm 

specifies the DOS file, file.asm, in the directory, /src, on the disk in the 
device file /dev/fdO. Note that slashes (and not backslashes) are used 
as filename separators for DOS pathnames. Arguments without a dev¬ 
ice: are assumed to be UNIX files. 

For convenience, the user configurable default file, 
/etc/default/msdos, can define DOS drive names to be used in place of 
the special device file pathnames. It can contain lines with the follow¬ 
ing format: 

A=/dev/fd0 

C=/dev/hd0d 

D=/dev/hdld 
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The drive letter A’ ’ may be used in place of special device file path¬ 
name /dev/fdO when referencing DOS files (see “Examples” below) 
The drive letter “C” or “D” refer to the DOS partition on the first or 
second hard disk. 

The commands operate on the following kinds of disks: 

DOS partitions on a hard disk 
5 1/4 inch DOS 
3 1/2 inch DOS 

8,9,15, or 18 sectors per track 
40 tracks per side 
1 or 2 sides 

DOS versions 1.0,2.0 or 3.0 

Conversions 


In the case of doscp, certain conversions are performed when copying 
a UNIX file. Filenames with a basename longer than eight characters 
are truncated. Filename extensions (the part of the name following 
separating period) longer than three characters are truncated. For 
example, the file 123456789.12345 becomes 12345678.123. A mes¬ 
sage informs the user that the name has been changed and the altered 
name is displayed. Filenames containing illegal DOS characters are 
stripped when writing to the MS-DOS format. A message informs the 
user that characters have been removed and displays the name as writ¬ 
ten. 

All DOS text files use a carriage-retum/linefeed combination, CR-LF , 
to indicate a newline. UNIX files use a single newline LF character. 
When the doscat and doscp commands transfer DOS text files to the 
UNIX filesystem, they automatically strip the CR. When text files are 
transferred to DOS , the commands insert a CR before each LF charac¬ 
ter. 

Under some circumstances the automatic newline conversions do not 
occur. The -m option may be used to ensure the newline conversion. 
The -r option can be used to override the automatic conversion and 
force the command to perform a true byte copy regardless of file type. 

Examples 


doscat /dev/fdO:/docs/memo.txt 

doscat /tmp/fl /tmp/f2 /dev/fdO:/src/file.asm 

dosdir /dev/fdO:/src 
dosdir A:/src A:/dev 

doscp /tmp/myfile.txt /dev/fdO:/docs/memo.txt 
doscp /tmp/fl /tmp/f2 /dev/fdO:/mydir 
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dosformat /dev/fdO 

dosls /dev/fdO:/src 
dosls B: 

dosmkdir /dev/fdO:/usr/docs 

dosrm /dev/fdO:/docs/memo.txt 
dosrm A:/docs/memol .txt 

dosrmdir /dev/fdO:/usr/docs 

Accessing DOS Filesystems From the UNIX Parti¬ 
tion 


The ability to mount DOS filesystems is an extension of the DOS utili- 
ties documented here. 

There are several limitations with the DOS directory structure which 
makes this a difficult task. These limitations are due to insufficient in¬ 
formation when compared to the UNIX filesystem. 

The DOS directory structure contains the following information: 

• Filename: up to 8 characters with 3 character extension 
(foo.bat) 

• File Attribute: read-only/read-write, hidden/visible file, 
system/normal file. Volume name/normal file name, 
subdirectory/normal file, archive/modified bit 

• Time of last modification 

• Date of last modification 

• Starting point (reference through FAT) 

• File size in bytes 

Using this information, it is converted to an actual UNIX inode. There 
are some UNIX provisions which cannot be carried over, because the 
filesystem must remain sane under DOS. 

• Any date in the UNIX inode table for the DOS filesystem is the 
same as the modification date (crime = atime = mtime). 

• The only types of nodes allowed in the DOS filesystem are 
directories and normal files. Pipes, semaphores, and special de¬ 
vice files do not exist because they do not have a counterpart 
under DOS. 
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• The permissions are 0777 for readable/writable files and 0555 
for read only files. If a user can access the filesystem, the user 
will be limited by the permissions available under the DOS 
directory structure. This permission is read-only or read write. 
When creating a file, the creator’s umask/mode is examined. 
The creation mode is based on the owner write bit. 

• The gid/uid for all files on the DOS filesystem is the same as 
the mountpoint. The mount point will maintain the necessary 
security. If a user can get into the mountpoint, then the user has 
the same access as the owner. 

• There is only one link for each file under the DOS filesystem. 

and are a special case and are not links. 

• On every change of the modification time (which on a UNIX 
system would change atime, ctime, mtime) the DOS archive bit 
is set. 

• Following DOS filesystem requirements, all blocks previous to 
a written block are allocated before the original block is writ¬ 
ten. This differs from UNIX systems where the program may 
seek out beyond the end of a file and write a block. UNIX sys¬ 
tems do not necessarily write blocks which have been skipped 
over. 

• If a program does not use the directory(S) system calls, but 
opens the directory in the DOS filesystem as a file, the program 
should see the DOS directory structure as it really exists. By 
using the directory^ S) system calls, the filesystem switch code 
will put together a UNIX style directory entry. 

• File contents are not mapped from the DOS filesystem. The file 
appears exactly as it is under DOS. For example, \r\n combina¬ 
tions are left as \r\n and not mapped to just \n. The file and 
directory names are mapped to uppercase. 

DOS File Conversion 


The utilities xtod(C) and dtox( C) can be used to convert the EOL 
sequences used to and from DOS, respectively. 


Files 


/etc/default/msdos 

/dev/fd* 

/dev/hd* 


Default information 


Floppy disk devices 
Hard disk devices 
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assign(C), dtype(C), mkfs(ADM), dtox(C), xtod(C), and “Using DOS 
and OS/2” in the System Administrator’s Guide 

Notes 


Using the DOS utilities, is not possible to refer to DOS directories with 
wild card specifications. The programs mentioned above cooperate 
among themselves so no two programs will access the same DOS disk. 
Only one process will access a given DOS disk at any time, while 
other processes wait. If a process has to wait too long, it displays the 
error message, “can’t seize a device,” and exits with an exit code of 
1 . 

You cannot use the dosformat command to format device A: because 
it is aliased to /dev/install, which cannot be formatted. Use /dev/rfdO/ 
instead. 

The following hard disk devices: 

/dev/hdOd 

/dev/rhdOd 

/dev/hdld 

/dev/rhdld 

are similar to /dev/hdOa in that the disk driver determines which parti¬ 
tion is the DOS partition and uses that as hd?d. This means that 
software using the DOS partition does not need to know which parti¬ 
tion is DOS. 

The Development System supports the creation of DOS executable 
files, using cc (CP). Refer to the C User’s Guide and C Library Guide 
for more information on using your UNIX system to create programs 
suitable for DOS systems. 

All of the DOS utilities leave temporary files in Itmp. These files are 
automatically removed when the system is rebooted. They can also be 
manually removed. 

You must have DOS 3.3 or earlier. Extended DOS partitions are not 
supported. 

Value Added 


doscat, doscp, dosdir, dosformat, dosls, dosmkdir, dosrm and dosrmdir 
are extensions of AT&T System V provided by the Santa Cruz Opera¬ 
tion. 
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dtox _ 

change file format from MS-DOS to UNIX 

Syntax 


dtox filename > outputfile 

Description 


The dtox command converts a file from MS-DOS format to UNIX for¬ 
mat. MS-DOS files terminate a line of text with a carriage return and a 
linefeed, while UNIX files terminate a line with a linefeed only. Also 
MS-DOS places a (CTL)z at the end of a file, while UNIX systems do 
not. Some programs and utilities are sensitive to this difference and 
some are not. If a text or data file is not being interpreted correctly, 
then use the dtox and xtod conversion utilities. The dtox command 
strips the extra carnage return from the end of each line and strips the 
(CTL)z from the end of the file. This utility is not required for binary 
object files. 

If no filename is specified on the command line, dtox takes input from 
standard input. Output of the utility goes to standard output. 

See Also 


xtod(C) 

Value Added 


dtox is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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dtype _ 

determines disk type 


Syntax 

dtype [-s] device ... 

Description 

dtype determines type of disk, prints pertinent information on the stan¬ 
dard output unless the silent (-s) option is selected, and exits with a 
corresponding code (see below). When more than one argument is 
given, the exit code corresponds to the last argument. 


Disk 

Exit 

Message 

Type 

Code 

(optional) 

Misc. 

60 

error (specified) 


61 

empty or unrecognized data 

Storage 

70 

backup format, volume n 


71 

tar format^ extent e of n] 


72 

cpio format 


73 

cpio character (-c) format 

MS-DOS 

80 

DOS 1.x, 8 sec/track, single sided 


81 

DOS 1.x, 8 sec/track, dual sided 


90 

DOS 2.x, 8 sec/track, single sided 


91 

DOS 2.x, 8 sec/track, dual sided 


92 

DOS 2.x, 9 sec/track, single sided 


93 

DOS 2.x, 9 sec/track, dual sided 


94 

DOS 2.x, fixed disk 


110 

DOS 3.x, 9 sec/track, dual sided 

XENIX 

120 

XENIX 2.x filesystem [needs cleaning] 


130 

XENIX 3.x or later filesvstem Ineeds cleaning] 

UNIX 

140 

UNIX IK filesystem [needs cleaning] 


Notes 


word-swapped refers to byte ordering of long words in relation to the 
host system. 

XENIX filesystems and backup and cpio binary formats may not be 
recognized if created on a foreign system. This is due to such system 
differences as byte and word swapping and structure alignment. 

This utility only works reliably for floppy diskettes. 
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Value Added 


DTYPE (C) 


dtype is an extension of AT&T System V provided by the Santa Cruz 
Operation. 


*- 
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du__ 

summarizes disk usage 

Syntax 

du [ -afrsu ] [ names ] 

Description 

du gives the number of blocks contained in all files and directories 
recursively within each directory and file specified by the names 
argument. The block count includes the indirect blocks of the file. If 
names is missing, the current directory is used. 

-s causes only the grand total (for each of the specified names) to be 
given, -a causes an entry to be generated for each file. Absence of 
either causes an entry to be generated for each directory only. 

The -f option causes du to display the usage of files in the current file 
system only. Directories containing mounted file systems will be 
ignored. The -u option causes du to ignore files that have more than 
one link. 

du is normally silent about directories that cannot be read, files that 
cannot be opened, etc. The -r option will cause du to generate mes¬ 
sages in such instances. 

A file with two or more links is only counted once. 


Notes 


If the -a option is not used, nondirectories given as arguments are not 
listed. 

If there are too many distinct linked files, du will count the excess 
files more than once. 

Files with holes in them will get an incorrect block count. 

This utility reports sizes in 512 byte blocks, du interprets 1 block 
from a 1024 byte block system as 2 of its own 512 byte blocks. Thus a 
500 byte file is interpreted as 2 blocks rather than 1. 
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du is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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echo 

echo 

Syntax 

echo [-n] [ arg ]... 

Description 


The echo command writes its arguments separated by blanks and ter¬ 
minated by a new-line on the standard output. The -n option prints a 
line without the new-line; same as using the \c escape sequence. 

echo also understands C-like escape conventions; beware of conflicts 
with the shell’s use of \: 

\b backspace 

\c print line without new-line 
\f form-feed 
\n new-line 
\r carriage return 
\t tab 

\v vertical tab 
\\ backslash 

\n The 8-bit character whose ASCII code is a 1, 2 or 3-digit octal 
number. In all cases, n must start with a zero. For example: 


echo 

"\07 " 

- Echoes Ctrl-G. 

echo 

"\007" 

- Also echoes Ctrl-G. 

echo 

"\065" 

- Echoes the number “5”. 

echo 

"\0101" 

- Echoes the letter “A”. 


The echo command is useful for producing diagnostics in com¬ 
mand files and for sending known data into a pipe. 

See Also 


sh(C) 
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Notes 


When representing an 8-bit character by using the escape conven¬ 
tion \0/?, the n must always be preceded by the digit zero (0). 

For example, typing: echo 'WARNING:\07' will print the phrase 
WARNING: and sound the “bell” on your terminal. The use of 
single (or double) quotes (or two backslashes) is required to protect 
the “\” that precedes the “07”. 

For the octal equivalents of each character, see ascii (M). 
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ed, red 


invokes the text editor 

Syntax 

ed [ - ] [ -p string ] [ file ] 
red [file] 

Description 

ed is the standard text editor. If the file argument is given, ed simu¬ 
lates an e command (see below) on the named file; that is to say, the 
file is read into ed 's buffer so that it can be edited, ed operates on a 
copy of the file it is editing; changes made to the copy have no effect 
on the file until a w (write) command is given. The copy of the text 
being edited resides in a temporary file called the buffer. There is 
only one buffer. 

red is a restricted version of ed(C). It will only allow editing of files 
in the current directory. It prohibits executing sh(C) commands via 
the ! command, red displays an error message on any attempt to 
bypass these restrictions. 

In general, red does not allow commands like 

Idate 


or 


!sh 

Furthermore, red will not allow pathnames in its command line. For 
example, the command; 

red /etc/passwd 

when the current directory is not /etc causes an error. 

Options 

The options to ed are: 

Suppresses the printing of character counts by the e, r, and w 
commands, of diagnostics from e and q commands, and the ! 
prompt after a Ishell command. 
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-p Allows the user to specify a prompt string. 

ed supports formatting capability. After including a forniat specifica¬ 
tion as the first lme of file and invoking ed with your terminal in stty 
-tabs or stty tab3 mode (see stty (C)), the specified tab stops will auto¬ 
matically be used when scanning file. For example, if the first line of 
a file contained: 

<:t5,10,15 s72:> 

tab stops would be set at columns 5, 10, and 15, and a maximum line 
length of 72 would be imposed. NOTE: While inputing text, tab char¬ 
acters are expanded to every eighth column as the default. 

Commands to ed have a simple and regular structure: zero, one, or two 
addresses followed by a single-character command, possibly followed 
by parameters to that command. These addresses specify one or more 
lines in the buffer. Every command that requires addresses has default 
addresses, so that the addresses can very often be omitted. 

In general, only one command may appear on a line. Certain com¬ 
mands allow the input of text. This text is placed in the appropriate 
place in the buffer. While ed is accepting text, it is said to be in input 
mode. In this mode, no commands are recognized; all input is merely 
collected. Input mode is left by entering a period (.) alone at the 
beginning of a line. 


ed supports a limited form of regular expression notation; regular 
expressions are used in addresses to specify lines and in some com- 
mands (e.g., s) to specify portions of a line that are to be substituted 
A regular expression specifies a set of character strings. A member of 
this set of strings is said to be matched by the regular expression. The 
regular expressions allowed by ed are constructed as follows: 

The following one-character regular expressions match a single char¬ 
acter: 

1.1 An ordinary character ( not one of those discussed in 1.2 below) 
is a one-character regular expression that matches itself. 

1.2 A backslash (\) followed by any special character is a one- 
character regular expression that matches the special character 
itself. The special characters are: 

a. ., *, [, and \ (dot, star, left square bracket, and backslash, 
respectively), which are otherwise special, except when they 
appear within square brackets ([]); see 1.4 below). 

b. (caret), which is special at the beginning of an entire regu¬ 
lar expression (see 3.1 and 3.2 below), or when it immedi¬ 
ately follows the left of a pair of square brackets ([]) (see 
1.4 below). 
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c. $ (dollar sign), which is special at the end of an entire regu¬ 
lar expression (see 3.2 below). 

d. The character used to bound (i.e., delimit) an entire regular 
expression, which is special for that regular expression (for 
example, see how slash (/) is used in the g command below). 

1.3 A period (.) is a one-character regular expression that matches 
any character except newline. 

1.4 A nonempty string of characters enclosed in square brackets (11) 
is a one-character regular expression that matches any one char¬ 
acter in that string. If, however, the first character of the string is 
a caret (*), the one-character regular expression matches any 
character except newline and the remaining characters in the 
string. The star (*) also has this special meaning only if it occurs 
first in the string. The dash (-) may be used to indicate a range of 
consecutive ASCII characters; for example, [0-9] is equivalent to 
[0123456789]. The dash (-) loses this special meaning if it 
occurs first (after an initial caret (*), if any) or last in the string. 
The right square bracket (]) does not terminate such a string 
when it is the first character within it (after an initial caret ( A ), if 
any); e.g., []a-ff] matches either a right square bracket (]) or one 
of the letters “a” through “f” inclusive. Dot, star, left bracket, 
and the backslash lose their special meaning within such a string 
of characters. 

Ranges of characters (characters separated by -) are treated according 
to the current locale’s collation sequence (see locale (M)). Therefore, 
if the collation sequence in use is A, a, B, b, C, c, then the expression 
[a-d] is equivalent to the expression [aBbCcDd]. 

To specify a collation item within a class, the item must be enclosed 
between [. and .] . Two character to one collation item mappings must 
be specified this way. For example, if the current collation rules 
specify that the characters “Ch” map to one character for collation 
purposes (as in Spanish), then this collation item would be specified as 
[.Ch.]. 

To specify a group of collation items, which are classified as equal 
unless all other collation items in the string also match, in which case 
a secondary “weight” becomes significant, a single member of that 
group must be enclosed between [= and =] . For example, if the char¬ 
acters A and a are in the same group then the class expressions 
[[=a=]b], [[=A=]b] and [Aab] are all equivalent. 

The ctype classes can also be specified within regular expressions. 
These are enclosed between [: and :] . The possible ctype classes are: 
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[:alpha:] 

[: upper:] 

[:lower:] 

[:digit:j 

[:alnum:] 

[:space:] 

[:print:] 

[:punct:] 

[:graph:] 

[:cntrl:] 


Matches alphabetic characters 
Matches upper case characters 
Matches lower case characters 
Matches digits 

Matches alphanumeric characters 
Matches white space 
Matches printable characters 
Matches punctuation marks 
Matches graphical characters 
Matches control characters 


The following rules may be used to construct regular expressions from 
one-character regular expressions: 

2.1 

A one-character regular expression followed by a star (*) is a regu¬ 
lar expression that matches zero or more occurrences of the one- 
character regular expression. If there is any choice, the longest 
leftmost string that permits a match is chosen. 

2.2 

A one-character regular expression followed by \{m\}, or 

\{m,n\} is a regular expression that matches a range of occurren¬ 
ces of the one-character regular expression. The values of m and n 
must be nonnegative integers less than 255; \{m\> matches exactly 
m occurrences; \{m,\} matches at least m occurrences; \{m,n\} 
matches any number of occurrences between m and n, inclusive. 
Whenever a choice exists, the regular expression matches as many 
occurrences as possible. 

2.3 

The concatenation of regular expressions is a regular expression 
that matches the concatenation of the strings matched by each 
component of the regular expression. 

2.4 

A regular expression enclosed between the character sequences \( 
and \) is a regular expression that matches whatever the unadorned 
regular expression matches. See 2.6 below for a discussion of why 
this is useful. 


2.5 

The expression \n matches the same string of characters as was 
matched by an expression enclosed between \( and \) earlier in the 
same regular expression. Here n is a digit; the subexpression 
specified is that beginning with the w-th occurrence of \( counting 
from the left. For example, the expression ~\(.*\)\1$ matches a 
line consisting of two repeated appearances of the same string. 

Finally, an entire regular expression may be constrained to match 
only an initial segment or final segment of a line (or both): 
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3.1 A caret ( A ) at the beginning of an entire regular expression con¬ 
strains that regular expression to match an initial segment of a 
line. 

3.2 A dollar sign ($) at the end of an entire regular expression con¬ 
strains that regular expression to match a final segment of a line. 
The construction A entire regular expression $ constrains the 
entire regular expression to match the entire line. 

The null regular expression (e.g., II) is equivalent to the last regular 
expression encountered. 

To understand addressing in ed , it is necessary to know that there is a 
current line at all times. Generally speaking, the current line is the last 
line affected by a command; the exact effect on the current line is dis¬ 
cussed under the description of each command. Addresses are con¬ 
structed as follows: 

1. The character . addresses the current line. 

2. The character $ addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. jc addresses the line marked with the mark name character x, 
which must be a lowercase letter. Lines are marked with the k 
command described below. 

5. A regular expression enclosed by slashes (/) addresses the first 
line found by searching forward from the line following the 
current line toward the end of the buffer and stopping at the first 
line containing a string matching the regular expression. If 
necessary, the search wraps around to the beginning of the buffer 
and continues up to and including the current line, so that the 
entire buffer is searched. 

6. A regular expression enclosed in question marks (?) addresses 
the first line found by searching backward from the line preced¬ 
ing the current line toward the beginning of the buffer and stop¬ 
ping at the first line containing a string matching the regular 
expression. If necessary, the search wraps around to the end of 
the buffer and continues up to and including the current line. See 
also the last paragraph before Files below. 

7. An address followed by a plus sign (+) or a minus sign (-) fol¬ 
lowed by a decimal number specifies that address plus or minus 
the indicated number of lines. The plus sign may be omitted. 

8. If an address begins with + or -, the addition or subtraction is 
taken with respect to the current line; e.g, -5 is understood to 
mean .-5. 
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9. If an address ends with + or then 1 is added to or subtracted 
from the address, respectively. As a consequence of this rule and 
of rule 8 immediately above, the address - refers to the line 
preceding the current line. (To maintain compatibility with ear¬ 
lier versions of the editor, the character ~ in addresses is entirely 
equivalent to -.) Moreover, trailing + and - characters have a 
cumulative effect, so — refers to the current line less 2. 

10. For convenience, a comma (,) stands for the address pair 1,$ 
while a semicolon (;) stands for the pair .,$. 

Commands may require zero, one, or two addresses. Commands that 
require no addresses regard the presence of an address as an error. 
Commands that accept one or two addresses assume default addresses 
when an insufficient number of addresses is given; if more addresses 
are given than such a command requires, the last address(es) are used. 

Typically, addresses are separated from each other by a comma (,). 
They may also be separated by a semicolon (;). In the latter case, the 
cunent line (.) is set to the first address, and only then is the second 
address calculated. This feature can be used to determine the starting 
lme for forward and backward searches (see rules 5 and 6 above). The 
second address of any two-address sequence must correspond to a line 
that follows, in the buffer, the line corresponding to the first address. 

In the following list of ed. commands, the default addresses are shown 
m parentheses. The parentheses are not part of the address. 

It is generally illegal for more than one command to appear on a line 
However, any command (except <?,/, r, or w) may be suffixed by p or 
by 1, m which case the current line is either printed or listed, respec¬ 
tively, as discussed below under the p and / commands. 

(•)a 

<text> 

The append command reads the given text and appends it after the 
addressed line; dot is left at the address of the last inserted line, or 
if there were no inserted lines, at the addressed line. Address 0 is 
legal for this command: it causes the “appended” text to be 
placed at the beginning of the buffer. 

(.)c 

<text> 

The change command deletes the addressed lines, then accepts 
input text that replaces these lines; dot is left at the address of the 
last lme mput, or, if there were none, at the first line that was not 
deleted. 

The delete command deletes the addressed lines from the buffer. 
The line after the last line deleted becomes the current line; if the 


March 15, 1989 


ED-6 





ED (C) 


ED (C) 


lines deleted were originally at the end of the buffer, the new last 
line becomes the current line. 


efile 


The edit command causes the entire contents of the buffer to be 
deleted, and then the named file to be read in; dot is set to the last 
line of the buffer. If no filename is given, the currently remem¬ 
bered filename, if any, is used (see the / command). The number 
of characters read is typed, file is remembered for possible use as 
a default filename in subsequent e, r, and w commands. If 
begins with an exclamation (!), the rest of the line is taken to be a 
shell command. The output of this command is read for the e and r 
commands. For the w command, the file is used as the standard 
input for the specified command. Such a shell command is not 
remembered as the current filename. 


E file 


The Edit command is like e , except the editor does not check to 
see if any changes have been made to the buffer since the last w 
command. 

file is given, the /ilename command changes the currently 
remembered filename to file ; otherwise, it prints the currently 
remembered filename. 

(1, $ )sJregular-expression I command list 

In the global command, the first step is to mark every line that 
matches the given regular expression. Then, for every such line, 
the given command, list is executed with . initially set to that line- 
A single command or the first of a list of commands appears on the 
same line as the global command. All lines of a multiline list 
except the last line must be ended with a \; a, i, and c commands 
and associated input are permitted; the . terminating mput mode 
may be omitted if it would be the last line of the command list . An 
empty command list is equivalent to the p command. The g, G, v, 
and V commands are not permitted in the command list. See also 
Notes and the last paragraph before Files below. 


(1, $ )Glregular-expression / 

In the interactive Global command, the first step is to mark every 
line that matches the given regular expression. Then, for every 
such line, that line is printed, dot (.) is changed to that line, and 
any one command (other than one of the a, c, i, g, G, v, and V 
commands) may be input and is executed. After the execution ot 
that command, the next marked line is printed, and so on. A new- 
line acts as a null command. An ampersand (&) causes the re- i 

execution of the most recent command executed within the current 
invocation of G. Note that the commands input as part of the exe¬ 
cution of the G command may address and affect any lines m the 
buffer. The G command can be terminated by entering an INTER¬ 
RUPT (pressing the DEL key). 


March 15,1989 


ED-7 





ED (C) 


ED (C) 


h 

The /zelp command gives a short error message that explains the 
reason for the most recent ? diagnostic. 

H 

The H &lp command causes ed to enter a mode in which error mes¬ 
sages are printed for all subsequent ? diagnostics. It will also 
explain the previous diagnostic if there was one. The H command 
alternately turns this mode on and off. It is initially off. 

(•)• 

<text> 

The insert command inserts the given text before the addressed 
line; dot is left at the address of the last inserted line, or if there 
were no inserted lines, at the addressed line. This command differs 
from the a command only in the placement of the input text. 
Address 0 is not legal for this command. 

(-, .+1 )j 

The join command joins contiguous lines by removing the appro¬ 
priate newline characters. If only one address is given, this com¬ 
mand does nothing. 

(.)kx 

The mar£ command marks the addressed line with name x, which 
must be a lowercase letter. The address 'x then addresses this line. 
Dot is unchanged. 

(•>•)! 

The /ist command prints the addressed lines in an unambiguous 
way: a few nonprinting characters (e.g., tab, backspace) are 
represented by mnemonic overstrikes, all other nonprinting charac¬ 
ters are printed in octal, and long lines are folded. An l command 
may be appended to any command other than e,f, r, or w. 

(.,.)ma 

The wove command repositions the addressed line(s) after the line 
addressed by a . Address 0 is legal for a and causes the addressed 
line(s) to be moved to the beginning of the file. It is an error if 
address a falls within the range of moved lines. Dot is left at the 
last line moved. 

(. )n 

The number command prints the addressed lines, preceding each 
line by its line number and a tab character. Dot is left at the last 
line printed. The n command may be appended to any command 
other than e,f, r, or w. 


(-»-)p 

The print command prints the addressed lines. Dot is left at the 
last line printed. The p command may be appended to any 
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command other than e,f, r, or w; for example, dp deletes the 
current line and prints the new current line. 


The editor will prompt with a * for all subsequent commands. The 
P command alternately turns this mode on and off. It is initially off. 


The < 7 uit command causes ed to exit. No automatic write of a file 
is done. 


The editor exits without checking if changes have been made in 
the buffer since the last w command. 


The read command reads in the given file after the addressed line. 
If no filename is given, the currently remembered filename, if any, 
is used (see e and f commands). The currently remembered 
filename is not changed unless file is the very first filename men¬ 
tioned since ed was invoked. Address 0 is legal for r and causes 
the file to be read at the beginning of the buffer. If the read is suc¬ 
cessful, the number of characters read is typed. Dot is set to the 
address of the last line read in. If file begins with !, the rest of the 
line is taken to be a shell command whose output is to be read. 
Such a shell command is not remembered as the current filename. 

(.,. )slregular-expression Ireplacement / or 

(.,. )s /regular-expression /replacement /g or 

(.,. )slregular-expression /replacement In n= 1-512 

The substitute command searches each addressed line for an oc¬ 
currence of the specified regular expression. In each line in which 
a match is found, all nonoverlapped matched strings are replaced 
by replacement if the global replacement indicator g appears after 
the command. If the global indicator does not appear, only the first 
occurrence of the matched string is replaced. It is an error for the 
substitution to fail on all addressed lines. Any character other than 
space or newline may be used instead of / to delimit regular- 
expression and replacement . Dot is left at the address of the last 
line on which a substitution occurred. 

The n character represents any number between one and 512. This 
number indicates the instance of the pattern to be replaced on each 
addressed line. 

An ampersand (&) appearing in replacement is replaced by the 
string matching the regular-expression on the current line. The 
special meaning of the ampersand in this context may be 
suppressed by preceding it with a backslash. The characters vt. 
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where n is a digit, are replaced by the text matched by the n-th reg¬ 
ular subexpression of die specified regular expression enclosed 
between \( and \). When nested parenthesized subexpressions are 
present, n is determined by counting occurrences of \( starting 
from the left. When the character % is the only character in 
replacement , the replacement used in the most recent substitute 
command is used as the replacement in the current substitute com¬ 
mand. The % loses its special meaning when it is in a replace¬ 
ment string of more than one character or when it is preceded by a 

A line may be split by substituting a newline character into it. The 
newline in the replacement must be escaped by preceding it with a 
\. Such a substitution cannot be done as part of a g or v command 
list. 

This command acts just like the m command, except that a copy of 
die addressed lines is placed after address a (which may be 0). Dot 
is left at the address of the last line of the copy. 


The undo command nullifies the effect of the most recent com¬ 
mand that modified anything in the buffer, namely the most recent 
a,c,d, g, i,j, m, r, s, t, v, G, or V command. 


(1, $ )v /regular-expression /command list 

This command is the same as the global command g except that 
the command list is executed with dot initially set to every line 
that does not match the regular expression. 

(1, $) V 1 regular-expression / 

This command is the same as the interactive global command G 
except that the lines that are marked during the first step are those 
that do not match the regular expression. 

(l,$)wfile 

The write command writes the addressed lines into the named file. 
If the file does not exist, it is created with mode 666 (readable and 
writeable by everyone), unless the umask setting (see sh(C)) dic¬ 
tates otherwise. The currently remembered filename is not 
changed unless file is the very first filename mentioned since ed 
was invoked. If no filename is given, the currently remembered 
filename, if any, is used (see e and / commands), and dot remains. 
If the command is successful, the number of characters written is 
displayed. If file begins with an exclamation (!), the rest of the 
line is taken to be a shell command to which the addressed lines 
are supplied as the standard input. Such a shell command is not 
remembered as the current filename. 
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The line number of the addressed line is typed. Dot is unchanged 
by this command. 

Ishell command 

The remainder of the line after the ! is sent to the UNIX shell 
(s/t(C)) to be interpreted as a command. Within the text of that 
command, the unescaped character % is replaced with the remem¬ 
bered filename. If a ! appears as the first character of the shell 
command, it is replaced with the text of the previous shell com¬ 
mand. Thus, !! will repeat the last shell command. If any expan¬ 
sion is performed, the expanded line is echoed. Dot is unchanged. 

(.+ 1 ) 

An address alone on a line causes the addressed line to be printed. 
A RETURN alone on a line is equivalent to .+lp. This is useful for 
stepping forward through the editing buffer a line at a time. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ques¬ 
tion mark (?) and returns to its command level. 

ed has size limitations: 512 characters per line, 256 characters per 
global command list, 64 characters per filename, and 128K characters 
in the buffer. The limit on the number of lines depends on the amount 
of user memory. 

When reading a file, ed discards ASCII NUL characters and all charac¬ 
ters after the last newline. Files (e.g., a.out) that contain characters 
not in the ASCII set (bit 8 on) cannot be edited by ed. 

If the closing delimiter of a regular expression or of a replacement 
string (e.g., /) would be the last character before a newline, that delim¬ 
iter may be omitted, in which case the addressed line is printed. Thus, 
the following pairs of commands are equivalent: 

s/sl/s2 s/sl/s2/p 
g/sl g/sl/p 

?sl ?sl? 

Files 


/tmp/e# Temporary; # is the process number 
ed.hup Work is saved here if the terminal is hung up 

See Also 

coltbl(M), grep(C), locale(M), sed(C), sh(C), stty(C), regexp(S) 
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? Command errors 
? file An inaccessible file 

Use the /zelp and Ht lp commands for detailed explanations. 

If changes have been made in the buffer since the last w command that 
wrote the entire buffer, ed warns the user if an attempt is made to de¬ 
stroy ed* s buffer via the e or q commands by printing ? and allowing 
you to continue editing. A second e or q command at this point will 
take effect. The dash (-) command-line option inhibits this feature. 

Notes 


An exclamation (!) command cannot be subject to a g or a v com¬ 
mand. 

The ! command and the ! escape from the e, r, and w commands can¬ 
not be used if the the editor is invoked from a restricted shell (see 
sh(C)). 

The sequence \n in a regular expression does not match any character. 
The / command mishandles DEL. 

Because 0 is an illegal address for the w command, it is not possible to 
create an empty file with ed. 

If the editor input is coming from a command file (i.e., ed file < ed- 
cmd-file), the editor will exit at the first failure of a command in the 
command file. 

Standards Conformance _ 

ed is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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enable _ 

turns on terminals and line printers 

Syntax 

enable tty ... 
enable printers 

Description 

For terminals this program manipulates the /etc/conf/init.base file and 
signals init to allow logins on a particular terminal. 

For line printers, enable activates the named printers and enables them 
to print requests taken by lp(C). Use lpstat(C) to find the status of the 
printers. 

Examples 

A simple command to enable ttyOl follows: 
enable ttyOl 

Files 

/dev/tty* 

/etc/conf/init.base 

/usr/spool/lp/* 

See Also 


disable(C), getty(M), init(M), login(M), lp(C), lpstat(C), inittab(F), 
uugetty(M) 

Authorization 


The behavior of this utility is affected by assignment of the printer - 
stat authorization, which is usually reserved for system administra¬ 
tors. Refer to the “Using a Trusted System” chapter of the User’s 
Guide for more details. 
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env _ 

sets environment for command execution 

Syntax 


env [-] [ name=value ]... [ command [args] ] 

Description 


env obtains the current environment , modifies it according to its argu¬ 
ments, then executes the command with the modified environment. 
Arguments of the form name=value are merged into the inherited 
environment before the command is executed. The - flag causes the 
inherited environment to be ignored completely, so that the command 
is executed with exactly the environment specified by the arguments. 

If no command is specified, the environment is printed, one name- 
value pair per line. 

See Also 


sh(C), exec(S), profile(F), environ(M) 

Notes 


The old printenv command was replaced in and System V by the env 
command. The current printenv is a link to env. 

Standards Conformance 


env is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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ex, edit _ 

invokes a text editor 

Syntax 

ex [ -s ] [ -v ] [ -t tag ] [ -r file ] [ -L ] [ -R ] [ -c command ] name ... 
edit [-r] [-x] [-C] name ... 

Description 

ex is the root of the editors ex and vi. ex is a superset of ed, with the 
most notable extension being a display editing facility. Display based 
editing is the focus of vi. 

edit is a variant of the text editor ex recommended for new or casual 
users who wish to use a command-oriented editor. It operates pre¬ 
cisely as ex(C) with the following options automatically set: 


novice 

ON 

report 

ON 

showmode 

ON 

magic 

OFF 


These options can be turned on or off via the set command in ex(C). 

Refer to the v/(C) page for a complete description of the ex com¬ 
mands. 

Files 


/usr/lib/ex3.7strings 
/usr/lib/ex3.7recover 
/usr/lib/ex3.7preserve 
/etc/termcap 
$HOME/.exrc 
/tmp/E xnnnnn 
/tmp/R xnnnnn 
/usr/preserve 


Error messages 

Recover command 

Preserve command 

Describes capabilities of terminals 

Editor startup file 

Editor temporary 

Named buffer temporary 

Preservation directory 
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See Also 


EX (C) 


awk(C), ctags(CP), ed(C), grep(C), sed(C), termcap(F), vi(C) 

Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 

Standards Conformance 

ex is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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expr _ 

evaluates arguments as an expression 

Syntax 


expr arguments 

Description 

The arguments are taken as an expression. After evaluation, the result 
is written on the standard output. Terms of the expression must be 
separated by blanks. Characters special to the shell must be escaped. 
Note that zero is returned to indicate a zero value, rather than the null 
string. Strings containing blanks or other special characters should be 
quoted. Integer-valued arguments may be preceded by a unary minus 
sign. Internally, integers are treated as 32-bit, 2’s complement 
numbers. 

The operators and keywords are listed below. Expressions should be 
quoted, since many of the characters that have special meaning in the 
shell also have special meaning in expr. The list is in order of increas¬ 
ing precedence, with equal precedence operators grouped within 
braces ({ and }). 

expr | expr . „ 

Returns the first expr if it is neither null nor 0, otherwise 

returns the second expr. 


expr & expr 

Returns the first expr if neither expr 
returns 0. 


is null nor 0, otherwise 


expr { =, >, >=, <, <=, != } expr . , 

Returns the result of an integer comparison if both arguments 
are integers, otherwise returns the result of a lexical com¬ 
parison, as defined by the locale. 


expr { +, - } expr 

Addition or subtraction of integer-valued arguments. 


expr { *, /, % } expr r t 

Multiplication, division, or remainder of the integer-valued 

arguments. 


The matching operator : compares the first argument with the 
second argument which must be a regular expression; regular 
expression syntax is the same as that of ed(C), except that all 
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patterns are anchored” (i.e., begin with a caret ( A )) and there¬ 
fore die caret is not a special character in that context. (Note 
that in the shell, the caret has the same meaning as the pipe 
symbol (I).) Normally the matching operator returns the 
number of characters matched (zero on failure). Alternatively, 
the \(...\) pattern symbols can be used to return a portion of 
the first argument. 

Examples 


1. a='expr $a + h 

Adds 1 to the shell variable a. 

2. # For $a ending in "/file" 
expr $a : '.*/\(.*\)' 

Returns the last segment of a pathname (i.e., file). Watch out 
for the slash alone as an argument: expr will take it as the divi¬ 
sion operator (see Notes on the next page). 

3. expr $VAR : 

Returns the number of characters in $VAR. 

See Also 

coltbl(M), ed(C), locale(M), sh(C) 

Diagnostics 


As a side effect of expression evaluation, expr returns the following 
exit values: * 1 2 * * * 6 

0 If the expression is neither null nor zero 

1 If the expression is null or zero 

2 For invalid expressions 

Other diagnostics include: 

syntax error For operator/operand errors, including unset vari¬ 

ables 

nonnumeric argument 

If arithmetic is attempted on a nonnumeric string 
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Notes 

After argument processing by the shell, expr cannot tell the difference 
between an operator and an operand except by the value. If $a is an 
equals sign (=), the command: 

expr $a = = 

looks like: 

expr = = = 

The arguments are passed to expr and will all be taken as the = opera¬ 
tor. The following permits comparing equals signs: 

expr X$a = X= 

Standards Conformance __ 


expr is conformant with: 

AT&T SVDD Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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factor 

factor a number 

Syntax 


factor [ number ] 

Description 


When factor is invoked without an argument, it waits for a number to 
be typed in. If you type in a positive number iess than l 46 (about 
7.2x10 ) it will factor the number and print its prime factors; each 
one is printed the proper number of times. Then it waits for another 
number. It exits if it encounters a zero or any non-numeric character. 

If factor is invoked with an argument, it factors the number as above 
and then exits. 

The time it takes to factor a number, n, is proportional to fn. It usu¬ 
ally takes longer to factor a prime or the square of a prime, than to fac¬ 
tor other numbers. 

Diagnostics 


factor ^returns an error message if the supplied input value is greater 
than 2 or is not an integer number. 
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false _ 

returns with a nonzero exit value 

Syntax 

false 

Description 


false does nothing except return with a nonzero exit value. true{ C), 
false’s counterpart, does nothing except return with a zero exit value. 
“False” is typically used in shell procedures such as: 

until false 
do 

command 

done 


See Also 


sh(C), true(C) 


Diagnostics 


false is any non-zero value. 


Standards Conformance 



false is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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file 

determines file type 

^ Syntax 

file [ -c ] [ -f ffile ] [ -m mfile ] arg ... 

Description 


The file command performs a series of tests on each argument in an 
attempt to classify it. If an argument appears to be ASCII, file exam¬ 
ines the first 512 bytes and tries to guess its language. If an argument 
is an executable a.out,/?/^ will print the version stamp, provided it is 
greater than 0. 


-c The -c option causes file to check the magic file for format errors. 
This validation is not normally carried out for reasons of efficiency. 
No file typing is done under -c. 


-f If the -f option is given, the next argument is taken to be a file con¬ 
taining the names of the files to be examined. 


-m 


The -m option instructs file to use an alternate magic file. 


The file command uses the file /etc/magic to identify files that have 
some sort of magic number , that is, any file containing a numeric or 
string constant that indicates its type. Commentary at the beginning 
of /etc/magic explains its format. 


Files 


/etc/magic 

See Also 


filehdr(F) 

Standards Conformance 


file is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 


September 24,1990 


FILE-1 











FIND (C) 


FIND (C) 


find 

finds files 

Syntax 

find pathname-list expression 


Description 

The find command is used to find files matching a certain set of selec¬ 
tion criteria, find recursively descends the directory hierarchy for each 
pathname in the pathname-list (i.e., one or more pathnames) seeking 
files that match a Boolean expression written in the primaries given 
below. 


Expressions 

For each file encountered, find evaluates the specified expression, 
formed of one or more of the following primary expressions, which 
may evaluate as true or false. In the descriptions, the argument n is 
used as a decimal integer where +n means more than n, -n means less 
than n and n means exactly n. 


-nam efile 


perm onum 


-type x 


True if file matches the current file name. Normal 
shell argument syntax may be used if escaped 
(watch out for the left bracket (D, the question 
mark (?) and the star (*)). 

True if the file permission flags exactly match 
onum (see chmod( C)). If onum is prefixed by a 
minus sign, all other modes become significant 
(see mknod( S)), including the file type, setuid, set- 
gid, and sticky bits rather than just 
read/write/execute modes for owner/group/other. 

True if the type of the file is x, where x is b for 
block special file, c for character special file, d for 
directory, p for named pipe (first-in-first-out), or f 
for regular file. 


-links n True if the file has n links. 

-size n[c] True if the file is n blocks long (512 bytes per 

block). If n is followed by a c, the size is in char¬ 
acters. 
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-mount 

Always true; restricts the search to the file system 
containing the directory specified, or if no direc¬ 
tory was specified, the current directory. 

-local 

True if the file physically resides on the local sys¬ 
tem. 

-inum num 

True if the file’s inode is num. This is useful for 
locating files with matching inodes. 

-user uname 

True if the file belongs to the user uname. If 
uname is numeric and does not appear as a login 
name in the /etc/passwd file, it is taken as a user 
ID. 

-group gname 

True if the file belongs to the group gname. If 
gname is numeric and does not appear in the 
/etc/group file as a group name, it is taken as a 
group ID. 

-atime n 

True if the file was last accessed n days ago. 

-mtime n 

True if the data in the file was last modified n days 
ago. 

-ctime n 

True if the file’s status was last changed (i.e. creat¬ 
ed or modified) n days ago. 

-exec cmd 

Executes shell command cmd. The end of cmd 
must be punctuated by an escaped semicolon. A 
command argument {} is replaced by the current 
path name. True if the executed cmd returns a 
zero value as exit status (most commands return a 
zero value on successful completion and a non¬ 
zero value if an error is encountered). 

-ok cmd 

Like -exec except that the generated command 
line is printed with a question mark first, and is 
executed only if the user responds by typing y. 

-cpio device 

Writes the current file on device in cpio (F) format 
(5120-byte records). Always true. 

-depth 

Causes all entries in a directory to be acted upon 
before the directory itself. This can be useful 
when used with cpio(C) or the -cpio expression to 
transfer files located in directories without write 
permission. Always true. 

-print 

Causes the current path name to be printed. This 
option is used to create a list of all files matched 
by the previous primaries. Always true. 
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-newer file True if the current file has been modified more 

recently than the argument file. 

( expression ) True if the parenthesized expression is true. Usu¬ 
ally used with the -o operator (see below), 
parentheses are used for grouping. Parentheses are 
special to the shell and must be escaped. 

The primaries may be combined using the following operators (in 
order of decreasing precedence): 

! The ! operator specifies the negation of the next primary (i.e., ! 
-newer file is true if the current file is not newer than file.). This is 
the equivalent of the logical “not” operator. 

-o Placing the -o operator between two primaries creates an expres¬ 
sion that is true if either of the two primaries is true. It should be 
used with parentheses (i.e., \( -perm 644 -o -perm 664 \) is true if 
the current file has permissions 644 or 664). This is equivalent to 
the logical “inclusive or” operator. 

Note that placing two primaries next to each other is the equivalent of 
the logical “and” operation. The precedence of this operation is less 
than that of the ! operator but greater than that of the -o operator. 

Examples 

The following command searches for files named chapterl in the 
current directory and all directories below it and sends the pathname 
of any such files it finds to the standard output: 

find . -name chapterl -print 

The following removes all files named core or with names ending in 
•out that have not been accessed in the last seven days. 

find / \( -name core -o -name "*.out" \) -atime +7 -exec rm {) \; 

Files 


/etc/passwd User names and uids 

/etc/group Group names and gids 

See Also 


cpio(C)(F), sh(C), stat(S), test(C) 
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-user uname 

True if the file belongs to the user uname. If 
uname is numeric and does not appear as a login 
name in the /etc/passwd file, it is taken as a user 
ID. 

-group gname 

True if the file belongs to the group gname. If 
gname is numeric and does not appear in the 
/etc/group file as a group name, it is taken as a 
group ID. 

-size n 

True if the file is n blocks long (512 bytes per 
block). 

-atime n 

True if the file was last accessed n days ago. 

-mtime n 

True if the data in the file was last modified n days 
ago. 

-ctime n 

True if the file’s status was last changed (i.e. 
created or modified) n days ago. 

-exec cmd 

Executes shell command cmd. The end of cmd 
must be punctuated by an escaped semicolon. A 
command argument {} is replaced by the current 
path name. True if the executed cmd returns a 
zero value as exit status (most commands return a 
zero value on successful completion and a non¬ 
zero value if an error is encountered). 

-ok cmd 

Like -exec except that the generated command 
line is printed with a question mark first, and is 
executed only if the user responds by typing y. 

-cpio device 

Writes the current file on device in cpio (F) format 
(5120-byte records). Always true. 

-depth 

Causes all entries in a directory to be acted upon 
before the directory itself. This can be useful 
when used with cpio(C) or the -cpio expression to 
transfer files located in directories without write 
permission. Always true. 

-print 

Causes the current path name to be printed. This 
option is used to create a list of all files matched 
by the previous primaries. Always true. 

-newer file 

True if the current file has been modified more 
recently than the argument file. 

(expression ) 

True if the parenthesized expression is true. Usu¬ 
ally used with the -o operator (see below), 
parentheses are used for grouping. Parentheses are 
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special to the shell and must be escaped. 

The primaries may be combined using the following operators (in 
order of decreasing precedence): 

! The ! operator specifies the negation of the next primary (i.e., ! 
-newer file is true if the current file is not newer than file.). This is 
the equivalent of the logical “not” operator. 

-o Placing the -o operator between two primaries creates an expres¬ 
sion that is true if either of the two primaries is true. It should be 
used with parentheses (i.e., X -perm 644 -o -perm 664 \) is true if 
the current file has permissions 644 or 664). This is equivalent to 
the logical “inclusive or” operator. 

Note that placing two primaries next to each other is the equivalent of 
the logical “and” operation. The precedence of this operation is less 
than that of the ! operator but greater than that of the -o operator. 

Examples 

The following command searches for files named chapterl in the 
current directory and all directories below it and sends the pathname 
of any such files it finds to the standard output: 

find . -name chapterl -print 

The following removes all files named core or with names ending in 
.out that have not been accessed in the last seven days. 

find / \( -name core -o -name "♦.out" \) -atime +7 -exec rm {} \ 

Files 


/etc/passwd User names and uids 

/etc/group Group names and gids 

See Also 

cpio(C)(F), sh(C), stat(S), test(C) 

Standards Conformance 


find is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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finger _ 

finds information about users 

Syntax 


finger [ -bfilpqsw ] [loginl [login2 ...] ] 

Description 


By default finger lists the login name, full name, terminal name and 
write status (as a before the terminal name if write permission is 
denied), idle time, login time, office location, and phone number (if 
they are known) for each current user. (Idle time is minutes if it is a 
single integer, hours and minutes if a colon (:) is present, or days and 
hours if a “d” is present.) 


A longer format also exists and is used by finger whenever a list of 
names is given. (Account names as well as first and last names of 
users are accepted.) This is a multiline format; it includes all the 
information described above as well as the user’s home directory and 
login shell, any plan which the person has placed in the file .plan in 
their home directory, and the project on which they are working from 
the file .project which is also in the home directory. 


finger options are: 


-b Briefer long output format of users. 

-f Suppresses the printing of the header line (short format), 
-i Quick list of users with idle times. 

-1 Forces long output format. 

-p Suppresses printing of the .plan files, 
q Quick list of users, 

s Forces short output format, 

w Forces narrow format list of specified users. 
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Files 


/etc/utmp Who file 

/etc/passwd User names, offices, phones, login directories, and shells 

$HOME/.plan Plans 

$HOME/.project Projects 

See Also 


who(C), w(C) 

Credit 

This utility was developed at the University of California at Berkeley 
and is used with permission. 

Notes 

Only the first line of the .project file is printed. 

Entries in the /etc/passwd file have the following format: 

login name.user password(coded):user ID:group ID.comments.home 
directory .login shell 

The comment field corresponds to what appears in the finger output. 
For example, in the following /etc/passwd entry: 


blf:*:47:5:Brian Foster, Mission, x70, 767-1234 
:/u/blf:/bin/sh 

the comment field, “Brian Foster, Mission, x70, 767-1234” , contains 
data for the “In Real Life” , “Office” , and “Home Phone” , columns 
of the finger listings. 

Idle time is computed as the elapsed time since any activity on the 
given te rminal This includes previous invocations of finger which 
may have modified the terminal’s corresponding device file /dev/tty??. 
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fixhdr __ 

changes executable binary file headers 

Syntax 


fixhdr option files 

Description 


fixhdr changes the header of output files created by link editors or 
assemblers. The kinds of modifications include changing the format of 
die header, the fixed stack size, the standalone load address, and sym- 
bol names. J 

Using fixhdr allows the use of binary executable files, created under 
other versions or machines, by simply changing the header informa¬ 
tion so that it is usable by the target cpu. 

These are the options to fixhdr : 


-xa Change the x.out format of the header to the a.out format. 

-xb Change the x.out format of the header to the b.out format. 

■x4 Change the x.out format of the header to the 4.2BSD a out 

format. 

-x5 [-n] Change the x.out format of the header to 5.2 (UNIX™ 
System V release 2) a.out format. The -n flag causes 
leading underscores on symbol names to be passed with 
no modifications. 


-ax-c [11,86] 

Change the a.out format of the header to the x.out format 
The -c flag specifies the target CPU. 11 specifies a PDP- 
11 CPU. 86 specifies one of the 8086 family of CPUs 
(8086,8088,80186,80286 or 80386). Y 

-bx Change the b.out format of the header to the x.out format. 


-5x [-n] Change the 5.2 (UNIX System V release 2) a.out format 
ol the header to the x.out format. The -n flag causes lead¬ 
ing underscores on symbol names to be passed with no 
modifications. 


Add the x.out header format to the 86rel object module 
format. See 86rel( F). 
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-F num 

Add (or change) the fixed stack size specified in the x.out 
format of the header, num must be a hexadecimal 
number. 

-Anum 

Add (or change) the standalone load address specified in 
the x.out format of the header, num must be a hexade¬ 
cimal number. 

-M[smlh] 

Change the model of the x.out or 86rel format. Model 
refers to the compiler model specified when creating the 
binary, s refers to small model, m refers to medium 
model, 1 refers to large model, and h refers to huge model. 

-v [2,3,5,7] 

Change the version of XENIX specified in the header. 
XENIX version 2 was based on UNIX Version 7. 

“S sl=s2 s s3=s4] 

Change symbol names, where symbol name si is changed 


tos2. 

.f Ensure that the resolution table is of non-zero size. 

-C cpu Set the cpu type, cpu can be 186,286,386,8086, others. 

Files 


/usr/bin/fixhdr 

See Also 


a.out(F), 86rel(F) 

Notes 


Give fixhdr one option at a time. If you need to make more than one 
kind of modification to a file, us e fixhdr on the original file. Then use it 
again on th e fixhdr output, specifying the next option. Copy the origi¬ 
nal file if you need an unmodified version as fixhdr makes the 
modifications directly to the file. 

Value Added __ 

fixhdr is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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format _ 

format floppy disks and mini-cartridge tapes 

Syntax 

format [-n] [-v] [-fj [-q] [device] [-i interleave] 

Description 


format formats diskettes for use on a UNIX system. It may be used 
e / r *^n eraCtively or from 1116 command line. The default drive is 


Options 


The following command line options are available: 

-f Suppresses the interactive feature. The format program does not 
wait for user-confirmation before starting to format the diskette. 
Regardless of whether or not you run format interactively, track 
and head information is displayed. 


device 

This specifies the device to be formatted. 

/dev/rfdO. 


The default device is 


-i interleave 

Specifies the interleave factor. 


-q Quiet option. Suppresses the track and head output information 
normally displayed. Although this option does not suppress the 
interactive prompt, it would typically be used with -f to produce no 
output at all. * 

-v Specifies format verification. 

-n Specifies that the diskette is not to be verified (overrides verifv 
entry m /etc/default/format). 


P e file /etc/default/format is used to specify the default device to be 
formatted and whether or not each diskette is to be verified The 

wTi^v-Tv J* * e „ format DEVICE=/dev/rfd/i«n and 
VERIFY—[yYnN], as m the following example: 
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DEVICE=/dev/rfd096dsl5 

VERIFY=y 

The device must be a character (raw) device. 

Usage 

To run format interactively, enter: 
format 

followed by any of the legal options except -f, and press RETURN. 
When you mn format interactively, you see the prompt: 


insert diskette in drive and press return when ready 

When you press RETURN at this prompt, format begins to format the 
diskette. 

If you specify the -f option, you do not see this prompt. Instead, the 
program begins formatting immediately upon invocation. 

Unless you specify the -q option, format displays which track and 
head it is currently on: 


track # head # 

The number signs above are replaced by the actual track and head 
information. 

Files 

/etc/default/format 
/dev/rfd[0 - n] 

See Also 

fd(HW) 

Notes 

The format utility does not format floppies for use under DOS; use the 
dosformat command documented in dos( C). 
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UNIX systems require error free floppies. 

It is not advisable to format a low density (48tpi) diskette on a high 
density (96tpi) floppy drive. Diskettes written on a high density drive 
should be read on high density drives. A low density diskette written 
on a high density drive may not be readable on a low density drive. 

The device Idevlinstall is used only for installing and reading floppies. 
Attempts made to format this device may result in an error. 
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getopt 


parses command options 


Syntax 


set — 'getopt optstring $*' 


Description 



getopt is used to check and break up options in command lines for 
parsing by shell procedures, optstring is a string of recognized option 
letters (see getopt (S)). If a letter is followed by a colon, the option is 
expected to have an argument which may or may not be separated 
from it by whitespace. The special option --is used to delimit the end 
of the options, getopt will place --in the arguments at the end of the 
options, or recognize it if used explicitly. The shell arguments ($1 $2 . 
..) are reset so that each option is preceded by a dash (-) and in its own 
shell argument. Each option argument is also in its own shell argu¬ 
ment. 

Example 

The following code fragment shows how one can process the argu¬ 
ments for a command that can take the options a and b, and the option 
o, which requires an argument: 


set- s getopt abo: $* x 

if [ $? !- 0 ] 
then 

echo "usage: $0 [-a | -b] [-o <arg>]" 
exit 2 
fi 

for i in $* 
do 

case $i in 

-a | -b)shift; FLAG=$i;; 

-o) OARG=$3; shift; shift;; 

-) shift; break;; 

esac 

done 

This code will accept any of the following as equivalent: 

cmd -aoarg 
cmd -a -o arg 
cmd -oarg -a 
cmd -a -oarg — 
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See Also 


GETOPT(C) 


sh(C), getopt(S) 

Diagnostics 


getopt prints an error message on the standard error when it 
encounters an option letter not included in optstring . 

Notes 


The “Syntax” given for this utility assumes the user has a sh(C ) shell. 

Standards Conformance 


getopt is conformant with: 

AT&T SVED Issue 2, Select Code 307-127. 
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getopts, getoptcvt _ 

parses command options 

Syntax 

getopts optstring name [arg ...] 

/usr/lib/getoptcvt [-b] file 

Description 

The getopts command is used by shell procedures to parse positional 
parameters and to check for legal options. It supports all applicable 
rules of the command syntax standard [see Rules 3-10, intro (C)]. It 
should be used in place of the getopt{ C) command. (See the Notes 
below.) 

This feature is only available in the Bourne shell. 

optstring must contain the option letters the command using getopts 
will recognize; if a letter is followed by a colon, the option is expected 
to have an argument, or group of arguments, which must be separated 
from it by white space. 

Each time it is invoked, getopts will place the next option in the shell 
variable name and the index of the next argument to be processed in 
the shell variable OPTIND. Whenever the shell or a shell procedure is 
invoked, OPTIND is initialized to 1. 

When an option requires an option-argument, getopts places it in the 
shell variable OPTARG. 

If an illegal option is encountered, ? will be placed in name. 

When the end of options is encountered, getopts exits with a non-zero 
exit status. The special option may be used to delimit the end of 
the options. 

By default, getopts parses the positional parameters. If extra argu¬ 
ments ( arg ...) are given on the getopts command line, getopts will 
parse them instead. 

The Iusrlliblgetoptcvt command reads the shell script in file , converts 
it to use getopts (C) instead of getopt (C), and writes the results to the 
standard output. 
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-b the results of running /usr/lib/getoptcvt will be portable to earlier 
UNIX releases, /usr/lib/getoptcvt modifies the shell script in file so 
that when the resulting shell script is executed, it determines at run 
time whether to invoke getopts(C) or getopt( C). 

So all new commands will adhere to the command syntax standard 
described in intro (C), they should use getopts (C ) or getopt (S) to 
parse positional parameters and check for options that are legal for 
that command (see Notes below). 

Examples 


The following fragment of a shell program shows how one might pro¬ 
cess the arguments for a command that can take the options a or b, as 
well as the option o, which requires an option-argument: 

while getopts abo: c 
do 

case $c in 

a | b) FLAG=$c;; 

o) OARG=$ OP TARG ; ; 

?) echo $USAGE 

exit 2;; 

esac 

done 

shift 'expr $OPTIND - 1' 

This code will accept any of the following as equivalent: 

cmd -a -b -o "xxx z yy" 
cmd -a -b -o "xxx z yy" — 
cmd -ab -o xxx,z,yy 
cmd -ab -o "xxx z yy" 

cmd -o xxx,z,yy -b -a 

See Also 


intro(C), sh(C), getopt(S) 

Notes 


Although the following command syntax rule [see intro (C)] relaxa¬ 
tions are permitted under the current implementation, they should not 
be used because they may not be supported in future releases of the 
system. As in the Example section above, a and b are options, and the 
option o requires an option-argument: 

cmd -aboxxx file (Rule 5 violation: options with 

option-arguments must not be grouped with other options.) 
cmd -ab -oxxx file (Rule 6 violation: there must be 

white space after an option that takes an option-argument.) 
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Changing the value of the shell variable OPTIND or parsing different 
sets of arguments may lead to unexpected results. 


Diagnostics 


getopts prints an error message to the standard error when it 
encounters an option letter not included in optstring. 
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gets _ 

gets a string from the standard input 

Syntax 

gets [ string ] 

Description 


gets can be used with csh (C) to read a string from the standard input. 
If string is given it is used as a default value if an error occurs. The 
resulting string (either string or as read from the standard input) is 
written to the standard output. If no string is given and an error 
occurs, gets exits with exit status 1. 

See Also 


line(C), csh(C) 
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greek 


select terminal filter 


Syntax 


greek [ -Tterminal ] 


Description 



greek is a filter that reinterprets the extended character set, as well as 
the reverse and half-line motions, of a 128-character TELETYPE 
Model 37 terminal for certain other terminals. Special characters are 
simulated by overstriking, if necessary and possible. If the argument 
is omitted, greek attempts to use the environment variable $TERM 
[see environ (M)]. Currently, the following terminal s are recognized: 

300 DASI300. 

300-12 DASI 300 in 12-pitch. 

300s DASI 300s. 

300s-12 DASI 300s in 12-pitch. 

450 DASI 450. 

450-12 DASI 450 in 12-pitch. 

1620 Diablo 1620 (alias DASI 450). 

1620-12 Diablo 1620 (alias DASI 450) in 12-pitch. 

2621 Hewlett-Packard 2621,2640, and 2645. 

2640 Hewlett-Packard 2621,2640, and 2645. 

2645 Hewlett-Packard 2621,2640, and 2645. 

4014 Tektronix 4014. 

hp Hewlett-Packard 2621,2640, and 2645. 

tek Tektronix 4014. 


Files 


/usr/bin/300 

/usr/bin/300s 

/usr/bin/4014 

/usr/bin/450 

/usr/bin/hp 

See Also 

300(C), 4014(C), 450(C), hp(C), tplot(ADM), environ(M), term(M) 
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grep, egrep, fgrep 

searches a file for a pattern 

Syntax 


grep [ -bchlnsvy ] [ -e expression ] [ files ] 
egrep [ -bchlnv ] [ -e expression ] [ files ] 
fgrep [ -bclnvxy ] [ -f expfile ] [ files ] 

Description 


Commands of the grep family search the input files (or standard input 
if no files are specified) for lines matching a pattern. Normally, each 
matching line is copied to the standard output. If more than one file is 
being searched, the name of the file in which each match occurs is 
also written to the standard output along with the matching line 
(unless the -h option is used, see below). 

grep patterns are limited regular expressions in the style of ed( C). 
grep uses a compact nondeterministic algorithm, egrep patterns are 
full regular expressions; it uses a fast deterministic algorithm that 
sometimes needs exponential space, fgrep patterns are fixed strings, 
fgrep is fast and compact. The following options are recognized: 

-v All lines but those matching are displayed. 

-x Displays only exact matches of an entire line, (fgrep only.) 

-c Only a count of matching lines is displayed. 

-1 Only the names of files with matching lines are displayed, 
separated by newlines. 

-h Prevents the name of the file containing the matching line from 
being prepended to that line. Used when searching multiple 
files. (This option works with grep and egrep only.) 

■n Each line is preceded by its relative line number in the file. 

-b Each line is preceded by the block number on which it was 
found. This is sometimes useful in locating disk block 
numbers by context. 

-s Suppresses error messages produced for nonexistent or unread¬ 
able files, (grep only). Note that the -s option will not 
suppress error messages generated by the -f option. 
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-y Tbms on matching of letters of either case in the input so that 
case is insignificant. Conversion between uppercase and 
lowercase letters is dependent on the locale setting, -y does 
not work with egrep . 

-e expression o xstrings 

Same as a simple expression argument, but useful when the 
expression begins with a dash (-). 

-f expfile 

The regular expression for grep or egrep , or strings list for 
fgrep is taken from the expfile. 

In all cases (except with -h) the filename is output if there is more 
than one input file. Care should be taken when using the characters $, 
*, [, A , |, (,), and \ in expression , because they are also meaningful to 
the shell. It is safest to enclose the entire expression or strings argu¬ 
ment in single quotation marks. For example: 

grep ’[Ss]omeone’ text.file 

This command would find all lines containing the word “someone” in 
the file textile, whether the initial “s” is uppercase or lowercase. 

Multiple strings can be specified in fgrep without using a separate 
strings file by using the quoting conventions of the shell to imbed 
newlines in the string argument. For example, if you were using the 
Bourne shell ( sh(C )) you might enter the following on the command 
line: 

fgrep "Someone 
someone" text.file 

This would have the same effect as the grep example above. See the 
csh{ C) manual page for ways to imbed newlines in a string when 
using csh(C). 

egrep accepts regular expressions as in ed{ C), with the addition of the 
following: 

- A regular expression followed by a plus sign (+) matches one or 
more occurrences of the regular expression. 

- A regular expression followed by a question mark (?) matches 0 or 
1 occurrences of the regular expression. 

- Two regular expressions separated by a vertical bar (I) or by a 
newline match strings that are matched by either regular expres¬ 
sion. 
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A regular expression may be enclosed in parentheses () for group¬ 
ing. For example: 

egrep '([Ss]omel[Aa]ny)one' text.file 

This example displays all lines in text.file containing the words 
someone or ‘anyone”, whether or not they are spelled with initial 
capital letters. Without the parentheses, this example would display 
all lines containing the words “some” or “anyone” (because the vert¬ 
ical bar (|) operator is of lower precedence than concatenation, see 
below). 


Because of the algorithm used, egrep does not support extended 
ranges as in ed(C): Ranges like [a-z] are interpreted on the basis of 
the machine’s collating sequence, not the collating sequence defined 
by the locale, grep supports col( C) extended ranges. 

The \( and \) operators, supported by ed(C), are not supported by 
egrep. 

The order of precedence of operators is [ ], then * ? +, then concatena¬ 
tion, then backslash (\) with newline or vertical bar (|). 


See Also 


coltbl(M), ed(C), locale(M), sed(C), sh(C) 

Diagnostics 


Exit status is 0 if any matches are found, 1 if no matches are found, 
and 2 for syntax errors or inaccessible files. 

Notes 

Ideally there should be only one grep, but there isn’t a single algo¬ 
rithm that spans a wide enough range of space-time tradeoffs. 

Lines are limited to 256 characters. Longer lines are truncated. 

When using grep with the -y option, the search is not made totally 
case insensitive in character ranges specified within brackets. 

Standards Conformance 


e 8 re P,fgrep and grep are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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grpcheck__ 

checks group file 

Syntax 

grpcheck [file] 

Description 

grpcheck verifies all entries in the group file. This verification 
includes a check of the number of fields, group name, group ID, and 
whether all login names appear in the password file. The default group 
file is /etc/group. 

Files 


/etc/group 

/etc/passwd 

See Also 

pwcheck(C), group(F), passwd(F) 

Diagnostics 

Group entries in /etc/group with no login names are flagged. 
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HD (C) 


hd__ 

displays files in hexadecimal format 

Syntax 

hd [ -format [ -s offset ] [ -n count ] [ file ]... 

Description 


The hd command displays the contents of files in hexadecimal, octal, 
decimal, and character formats. Control over the specification of 
ranges of characters is also available. The default behavior is with the 
following flags set: “-abx -A”. This says that addresses (file offsets) 
and bytes are printed in hexadecimal and that characters are also 
printed. If no file argument is given, the standard input is read. 

Options include: 

-s offset Specify the beginning offset in the file where printing is 
to begin. If no ‘file’ argument is given, or if a seek fails 
because the input is a pipe, ‘offset’ bytes are read from 
the input and discarded. Otherwise, a seek error will 
terminate processing of the current file. 

The offset may be given in decimal, hexadecimal (pre¬ 
ceded by ‘Ox’), or octal (preceded by a ‘0’). It is option¬ 
ally followed by one of the following multipliers: w, 1, 
b, or k; for words (2 bytes), long words (4 bytes), half 
kilobytes (512 bytes), or kilobytes (1024 bytes), respec¬ 
tively. Note that this is the one case where “b” does 
not stand for bytes. Since specifying a hexadecimal 
offset in blocks would result in an ambiguous trailing 
‘b\ any offset and multiplier may be separated by an 
asterisk (*). 

-n count Specify the number of bytes to process. The count is in 
the same format as offset , above. 

Format Flags 


Format flags may specify addresses, characters, bytes, words (2 bytes) 
or longs (4 bytes) to be printed in hex, decimal, or octal. Two special 
formats may also be indicated: text or ascii. Format and base 
specifiers may be freely combined and repeated as desired in order to 
specify different bases (hexadecimal, decimal or octal) for different 
output formats (addresses, characters, etc.). All format flags appearing 
in a single argument are applied as appropriate to all other flags in that 
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argument. 

acbwlA 

Output format specifiers for addresses, characters, bytes, words, 
longs and ascii respectively. Only one base specifier will be used 
for addresses. The address will appear on the first line of output 
that begins each new offset in the input. 

The character format prints all printable characters without 
change, special C escapes as defined in the language, and the 
remaining values in the specified base. 

The ascii format prints all printable characters without change, and 
all others as a period (.). This format appears to the right of the 
first of other specified output formats. A base specifier has no 
meaning with the ascii format. If no other output format (other than 
addresses) is given, bx is assumed. If no base specifier is given, all 
of xdo are used. 

xdo 

Output base specifiers for hexadecimal, decimal and octal. 

t Print a text file, each line preceded by the address in the file. Nor¬ 
mally, lines should be terminated by a \n character; but long lines 
will be broken up. Control characters in the range 0x00 to Ox If are 
printed as to ‘V- Bytes with the high bit set are preceded by 
a tilde (~) and printed as if the high bit were not set. The special 
characters C, ~, \) are preceded by a backslash (\) to escape their 
special meaning. As special cases, these two values are 
represented numerically as ‘\177’ and ‘\377\ This flag will over¬ 
ride all output format specifiers except addresses. 

If no output format is given, but a base specifier is present, the output 
format is set to -acbwl. If no base specifier is given, but an output for¬ 
mat is present, the base specifier is set to -xdo. If neither is present, 
the format flag is set to -abx -A. 

Value Added 


hd is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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head _ 

prints the first few lines of a file 

Syntax 


head [ -count ] [ file ... ] 

Description _ 

This filter prints the first count lines of each of the specified files. If 
no files are specified, head reads from the standard input. If no count 
is specified, then 10 lines are printed. 

See Also 

tail(C) 

Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 
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HELLO (C) 


hello _ 

send a message to another user 

Syntax 

hello user [ tty ] 

Description 


hello sends messages from one user to another. When first called, 
hello displays the following message: 

Message from sender’s-system! sender’s-name sender’s-tty 

The recipient of the message should write back at this point. Com¬ 
munication continues until an interrupt is sent. (On most terminals, 
pressing the Del key sends an interrupt.) At that point hello prints 
“(end of message)’ ’ on the other terminal, and exits. 

To write to a user who is logged in more than once, the user can 
employ the tty argument to specify the appropriate terminal name. 
The who(C) command can be used to determine the correct terminal 
name. 

Permission to write may be allowed or denied by the recipient, using 
the mesg command. Writing is allowed by default. Certain com¬ 
mands, such as nroff and pr, prohibit messages in order to prevent 
disruption of output. 

If the character ! is found at the beginning of a line, hello calls the 
shell to execute the rest of the line as a command. 

The following protocol is suggested for using hello. When first writ¬ 
ing to another user, the sender should wait for that user to write back 
before sending a message. Each party should end each message with a 
signal indicating that the other may reply: o for “over” is conven¬ 
tional. The signal oo for “over and out” is suggested when conversa¬ 
tion is about to be terminated. 

Files 


/etc/utmp 

/bin/sh 

See Also 


mesg(C), who(C), mail(C) 
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Value Added 


HELLO (C) 


hello is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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HP (C) 


h£_ , 

handle special functions of Hewlett-Packard terminals 

Syntax 

hp [ -e ] [ -m ] 

Description 


hp supports special functions of the Hewlett-Packard 2640 series of 
terminals, with the primary purpose of producing accurate representa¬ 
tions of most nr off output. A typical usage is in conjunction with text 
processing software: 

nroff -h files ... | hp 

Regardless of the hardware options on your terminal, hp tries to do 
sensible things with underlining and reverse line-feeds. If the termi¬ 
nal has the “display enhancements” feature, subscripts and super¬ 
scripts can be indicated in distinct ways. If it has the “mathematical- 
symbol” feature, Greek and other special characters can be displayed. 

The flags are as follows: 

-e It is assumed that your terminal has the “display enhancements” 
feature, and so maximal use is made of the added display modes. 
Overstruck characters are presented in the Underlined mode. 
Superscripts are shown in Half-bright mode, and subscripts in 
Half-bright, Underlined mode. If this flag is omitted, hp assumes 
that your terminal lacks the “display enhancements” feature. In 
this case, all overstruck characters, subscripts, and superscripts are 
displayed in Inverse Video mode, i.e., dark-on-light, rather than the 
usual light-on-dark. 

Requests minimization of output by changing newlines to "M’s. 
Any contiguous sequence of 3 or more new-lines is converted into 
a sequence of only 2 new-lines; i.e., any number of successive 
blank lines produces only a single blank output line. This allows 
you to retain more actual text on the screen. 

With regard to Greek and other special characters, hp provides the 
same set as 300(C), except that “not” is approximated by a right 
arrow, and only the top half of the integral sign is shown. 
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Diagnostics 


HP (C) 


line too long if the representation of a line exceeds 1,024 characters. 
The exit codes are 0 for normal termination, 2 for all errors. 

See Also 


300(C), greek(C) 

Notes 


An ‘overstriking sequence” is defined as a printing character fol¬ 
lowed by a backspace followed by another printing character. In such 
sequences, if either printing character is an underscore, the other print¬ 
ing character is shown underlined or in Inverse Video; otherwise, only 
Ae first printing character is shown (again, underlined or in Inverse 
Video). Nothing special is done if a backspace is adjacent to an ASCII 
control character. Sequences of control characters (e.g., reverse line¬ 
feeds, backspaces) can make text “disappear’ In particular, tables 
generated by tbl (CT) mat contain vertical lines will often be missing 
the lines of text that contain the “foot” of a vertical line, unless me 
input to hp is piped through co/(C). 


Although some terminals do provide numerical superscript characters 
no attempt is made to display them. 
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hwconfig__ 

read the configuration information 

Syntax 

/etc/hwconflg [-nlh] [-f filename] [ [-] param] [ [-] param=val] ... 

Description 

hwconfig returns the configuration information contained in the file 
/usr/adm/hwconfig or the file specified on the command line with the 
-f filename option. Using combinations of the remaining options, the 
user can view as much information as needed from the configuration 
file. The display format is as follows: 


magic char device name base-{-finish vec dma rest 

where: 

magicjchar 

is the character % 

device name 

is the name of the device driver 

base-{-finish 

is the starting and the finishing addresses of 
the driver working space 

vec 

is the interrupt vector number 

dma 

is the dma channel number 

rest 

is a possibly empty list of parameter=value 
pairs 

The default hwconfig display looks similar to this: 


device 

address 

vector 

dma comment 

fpu 

_ 

35 

type=80387 

floppy 

0x3F2-0x3F7 

06 

2 unit=0 type=96dsl5 

serial 

0x2F8-0x2FF 

03 

unit=l type=Standard nports=l 

parallel 0x378-0x37A 

07 

- unit=0 

console 


- 

- unit=ega type=0 

disk 

0xlF0-0xIF7 

36 

type=W0 unit=0 cyls=791 hds=16 secs=48 


Options 


the device name is always printed out. 
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HWCONFIG (C) 

-1 

the long format of the device configuration 
content is used. 

-h 

uses the long format, with headers. 

-f file 

uses file as the input file instead of the default 
/usr/adm/hwconfig. 

param 

any of the 12 pre-defined parameters avail¬ 
able: name, base, offset, vec, dma, unit, type, 
nports, hds, cyls, secs, and drvr. 

-param 

shows all values of param throughout the con¬ 
figuration file, param can be any valid system 
parameter. 

-param=val 

shows only information from the line where 
param equals the value val. 


The -n, -I and -h options are in increasing overriding power. That is, if 
-n and -1 are both specified, -I will be used, param on its own indi¬ 
cates a query for its corresponding value(s), whereas param=value 
indicates a matching <token,val> pair in the input file. -1 is used by 
default if there are no queries and no explicit option. 

Command line queries, i.e. those with parameters only, are always 
displayed in short format. 

Examples 


hwconfig The entire contents of the file /usr/adm/hwconfig is 
printed. 

hwconfig base 

All the values of the base parameter found in 
/usr/adm/hwconfig are printed. 

hwconfig -f conf base=300 vec=19 

All entries in conf that match the base and vec values 
given are printed. 

hwconfig name=floppy base 

The name and value of base in /usr/adm/hwconfig for the 
drivers with the name floppy are printed for all entries. 

hwconfig -n base dma 

The device name associated with the base and dma is 
displayed. For example: 
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name=scsi base=0x234 dma—4 


hwconflg base dma vec=4 

The base and dma values of all /usr/adm/hwconflg entnes with 
matching vec=4 are printed. 

hwconflg -1 base dma vec=4 

is like 

hwconflg -1 vec=4 

except that base and dma values will be printed first. 

hwconflg -h . 

Everything is printed in the long format, with a header similar to 
the one shown at boot-up time. It will ignore all queries, but do 
matching on the token values. For example, 

hwconfig -h vec=4 dma=l 

will print in long format, with header, all those entries with vec=4 and 
dma=l 


Files 

/usr/adm/hwconfig 

Value Added 

hwconfig is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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I286EMUL (C) 


i 286 emul _ 

emulate UNIX 80286 

Syntax 

i286emul [ arg ... ] prog286 

Description 


i286emul is an emulator that allows programs from UNIX System V 
Release 2 or Release 3 on the Intel 80286 to run on UNIX System V 
Release 3 on the Intel 80386. 

The UNIX system recognizes an attempt to exec (S) a 286 program, 
and automatically exec’s the 286 emulator with the 286 program name 
as an additional argument. It is not necessary to specify the i286emul 
emulator on the command line. The 286 programs can be invoked 
using the same command format as on the 286 UNIX System V. 

i286emul reads the 286 program’s text and data into memory and maps 
them through the LDT (Local Descriptor Table) (via sysi86( S)) as 286 
text and data segments. It also sets callgate 89 in the GDT (Global 
Descriptor Table) (which is used by 286 programs for system calls) to 
point to a routine in i286emul. i286emul starts the 286 program by 
jumping to its entry point. 

When the 286 program attempts to do a system call, i286emul takes 
control. It does any conversions needed between the 286 system call 
and the equivalent 386 system call, and performs the 386 system call. 
The results are converted to the form the 286 program expects, and the 
286 program is resumed. 

The following are some of the differences between a program r unning 
on a 286 and a 286 program using i286emul on a 386: 

• A 286 program under i286emul always has 64K in the stack 
segment if it is a large-model process, or 64K in the data seg¬ 
ment if it is a small-model process. 

• System calls and signal handling use more space on the stack 
under i286emul than it does on a 286. 

• Attempts to unlink or write on the 286 program will fail on the 
286 with ETXTBSY. Under i286emul, they will not fail. 

• ptrace (S) is not supported under i286emul. 

• The 286 program must be readable for the emulator to read it. 


March 15,1989 


I286EMUL-1 








I286EMUL (C) I286EMUL(C) 

Files 


/bin/i286emul .... 

The emulator must have this name and be in /bin if it is to be 
automatically invoked when exec (S) is used on a 286 program. 


Notes 


The signal mechanism under the emulator is the System V release 2 
signal mechanism rather than the System V release 3 mechanism. 
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id__ 

prints user and group IDs and names 

Syntax 


id 

Description 


id writes a message on the standard output, giving the user and group 
IDs and the corresponding names of the invoking process. If the effec- 
tive and real IDs do not match, both are printed. 

See Also 


logname(C), getuid(S) 

Standards Conformance 


id is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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ismpx _ 

return windowing terminal state 

Syntax 

ismpx [-s] 

Description 

The ismpx command reports whether its standard input is connected to 
a multiplexed xt(HW) channel; i.e., whether it’s running under 
layers(C ) or not. It is useful for shell scripts that download programs 
to a windowing terminal or depend on screen size. 

The ismpx command prints yes and returns 0 if invoked under 
layers( C), and prints no and returns 1 otherwise. 

-s Do not print anything; just return the proper exit status. 

Diagnostics 

Returns 0 if invoked under layers(C), 1 if not. 

See Also 


jwin(C), layers(C), xt(HW) 

Example 


if ismpx -s 
then 

jwin 

fi 
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join _ 

joins two relations 


Syntax 


join [ options ] filel file2 

Description 


join prints to the standard output a join of the two relations specified 
by the lines of filel ondfile2 . If filel is a dash (-), the standard input 
is used. r 

Filel and file2 must be sorted in increasing ASCII collating sequence 
on the fields on which they are to be joined, normally the first in each 
lme. 

There is one line in the output for each pair of lines in filel and file2 
that have identical join fields. The output line normally consists of 
the common field, then the rest of the line from filel , then the rest of 
the line from file2. 

Fields are normally separated by blank, tab or newline. In this case, 
multiple separators count as one, and leading separators are discarded. 

These options are recognized: 

In addition to the normal output, produces a line for each 
unpayable line in file n, where n is 1 or 2. 

Replaces empty output fields by string 5 . 

Joins on the /nth field of file n. If n is missing, uses the 
/nth field in each file. 

Each output line comprises the fields specified in list , 
each element of which has the form n./n, where n is a file 
number and m is a field number. 

Uses character c as a field separator. Every appearance of 
c in a line is significant. 


-an 

-es 
-j n m 

-o list 

-t c 
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JOIN (C) 

See Also 


JOIN (C) 


awk(C), comm(C), sort(C) 

Notes 

With default field separation, the collating sequence is that of sort -b. 
With -t, the sequence is that of a plain sort. 

Standards Conformance 

join is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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jterm _ 

reset layer of windowing terminal 


Syntax 

jterm 


Description 


Jwh ?°T and 18 U8ed , to reset 3 la y er of a windowing tenninal 
hntP«nfTT dm8 3termmal program that changes the tenninal attri¬ 
butes of the layer. It is useful only under layers(C). In practice it is 

!^?nl " 0nl y used to restart ^ default terminal emulator’after 
c mate T P rovided with a terminal-specific application 
package. For example, on the AT&T TELETYPE 5620 DMD termi¬ 
nal, after executing the hp2621( C) command in a layer, issuing the 
jterm command will restart the default terminal emulator in that llyer 


Diagnostics 


Returns 0 upon successful completion, 1 otherwise. 

Notes 


The layer that is reset is the one attached to standard error; that is the 
wmdow you are m when you type the jterm command. 


See Also 


layers(C) 
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jwin _ 

print size of layer 

Syntax 


jwin 

Description 

The jwin command runs only under layers(C) and is used to determine 
the size of the layer associated with the current process. It prints the 
width and the height of the layer in bytes (number of characters across 
and number of lines, respectively). For bit-mapped terminals only, it 
also prints the width and height of the layer in bits. 

Diagnostics___ 


Returns 0 on successful completion, 1 otherwise. 

If layers(C) has not been invoked, an error message is printed: 
jwin: not mpx 

Note___ 

The layer whose size is printed is the one attached to standard input; 
that is, the window you are in when you type the jwin command. 


See Also 


layers(C) 

Example 


In the following example, the user input is in bold: 
$ jwin 

bytes: 86 25 

bits: 780 406 
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kill 

terminates a process 

^ Syntax _ 

kill [ -signo ] processid ... 

Description 


kill sends signal 15 (terminate) to the specified process(es). This will 
normally kill processes that do not catch or ignore the signal. The 
process number of each asynchronous process (background process) 
started with & is reported by the shell (unless more than one process is 
started in a pipeline, in which case the number of the last process in 
the pipeline is reported). Process numbers can also be found by using 
ps{C). 


For example, if process number 0 is specified, all processes in the pro¬ 
cess group are signaled. 


The killed process must belong to the current user unless he is the 
super-user. 


If a signal number preceded by - is given as the first argument, that 
signal is sent instead of the terminate signal (see signal (S)). In partic¬ 
ular “kill -9 ..is a sure kill. 


See Also 


ps(C), sh(C), kill(S), signal(S) 

Standards Conformance 


kill is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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ksh, rksh 

KornShell, a standard/restricted command and pro¬ 
gramming language 

Syntax 

ksh [ ±aefhikmnoprstuvx ] [ ±o option ]... [ -c string ] [ arg ... ] 
rksh [ ±aefhikmnoprstuvx ] [ ±o option ]... [ -c string ] [ arg ... ] 

Description 


ksh is a command and programming language that executes com¬ 
mands read from a terminal or a file, rksh is a restricted version of the 
command interpreter ksh ; it is used to set up login names and execu¬ 
tion environments whose capabilities are more controlled than those 
of the standard shell. See Invocation below for the meaning of argu¬ 
ments to the shell. 

Definitions 

A metacharacter is one of the following characters: 

;&()|<> new-line space tab 

A blank is a tab or a space. An identifier is a sequence of letters, 
digits, or underscores starting with a letter or underscore. Identifiers 
are used as names for functions and named parameters . A word is a 
sequence of characters separated by one or more non-quoted meta¬ 
characters . 

A command is a sequence of characters in the syntax of the shell lan¬ 
guage. The shell reads each command and carries out the desired 
action either directly or by invoking separate utilities. A special com¬ 
mand is a command that is carried out by the shell without creating a 
separate process. Except for documented side effects, most special 
commands can be implemented as separate utilities. 


Commands 

A simple-command is a sequence of blank separated words which may 
be preceded by a parameter assignment list. (See Environment 
below). The first word specifies the name of the command to be exe¬ 
cuted. Except as specified below, the remaining words are passed as 
arguments to the invoked command. The command name is passed as 
argument 0 (see exec (S)). The value of a simple-command is its exit 
status if it terminates normally, or (octal) 200 +status if it terminates 
abnormally (see signal (S) for a list of status values). 
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A pipeline is a sequence of one or more commands separated by |. 
The standard output of each command but the last is connected by a 
pipe(S) to the standard input of the next command. Each command is 
run as a separate process; the shell waits for the last command to ter¬ 
minate. The exit status of a pipeline is the exit status of the last com¬ 
mand. 

A list is a sequence of one or more pipelines separated by &, &&, 
or | |, and optionally terminated by &, or | &. Of these five sym¬ 
bols, and | & have equal precedence, which is lower than that of 
&& and | |. The symbols && and | | also have equal precedence. A 
semicolon (;) causes sequential execution of the preceding pipeline; 
an ampersand (&) causes asynchronous execution of the preceding 
pipeline (i.e., the shell does not wait for that pipeline to finish). The 
symbol | & causes asynchronous execution of the preceding command 
or pipeline with a two-way pipe established to the parent shell. The 
standard input and output of the spawned command can be written to 
and read from by the parent Shell using the -p option of the special 
commands read and print described later. The symbol && ( | |) 
causes the list following it to be executed only if the preceding pipe¬ 
line returns a zero (non-zero) value. An arbitrary number of new-lines 
may appear in a list, instead of a semicolon, to delimit a command. 

A command is either a simple-command or one of the following. 
Unless otherwise stated, the value returned by a command is that of 
the last simple-command executed in the command. 

for identifier [ in word ... ] ;do list ;done 

Each time a for command is executed, identifier is set to the next 
word taken from the in word list. If in word ... is omitted, then 
the for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execu¬ 
tion ends when there are no more words in the list. 

select identifier [ in word ... ] ;do list ;done 

A select command prints on standard error (file descriptor 2), the 
set of words, each preceded by a number. If in word ... is omit¬ 
ted, then the positional parameters are used instead (see Parameter 
Substitution below). The PS3 prompt is printed and a line is read 
from the standard input. If this line consists of the number of one 
of the listed words, then the value of the parameter identifier is set 
to the word corresponding to this number. If this line is empty the 
selection list is printed again. Otherwise the value of the parame¬ 
ter identifier is set to null. The contents of the line read from stan¬ 
dard input is saved in the parameter REPLY. The list is executed 
for each selection until a break or end-offile is encountered. 

case word in [ [ (]pattern [ | pattern ]...) list ;; ]... esac 

A case command executes the list associated with the first pattern 
that matches word. The form of the patterns is the same as that 
used for file-name generation (see File Name Generation below). 
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if list ;then list [ elif -list ;then list ] ... [ ;else list ] ;fi 

The list following if is executed and, if it returns a zero exit status, 
the list following the first then is executed. Otherwise, the list fol¬ 
lowing elif is executed and, if its value is zero, the list following 
the next then is executed. Failing that, the else list is executed. If 
no else list or then list is executed, then the if command returns a 
zero exit status. 

while list ;do list ;done 
until list ;do list ;done 

A while command repeatedly executes the while list and, if the 
exit status of the last command in the list is zero, executes the do 
list; otherwise the loop terminates. If no commands in the do list 
are executed, then the while command returns a zero exit status; 
until may be used in place of while to negate the loop termination 
test. 

(list) 

Execute list in a separate environment. Note, that if two adjacent 
open parentheses are needed for nesting, a space must be inserted 
to avoid arithmetic evaluation as described below. 

Hist;} 

list is simply executed. Note that unlike the metacharacters ( and 
), { and } are reserved words and must at the beginning of a line or 
after a ; in order to be recognized. 

[[expression ]] 

Evaluates expression and returns a zero exit status when expres¬ 
sion is true. See Conditional Expressions below, for a description 
of expression. 

function identifier { list ;} 
identifier () { list ;} 

Define a function which is referenced by identifier. The body of 
the function is the list of commands between { and }. (See Func¬ 
tions below). 

time pipeline 

The pipeline is executed and the elapsed time as well as the user 
and system time are printed on standard error. 

The following reserved words are only recognized as the first word of 
a command and when not quoted: 

if then else elif fi case esac for while until do done 
{ } function select time [[ ]] 
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Comments 

A word beginning with # causes that word and all the following char¬ 
acters up to a new-line to be ignored. 

Aliasing 

The first word of each command is replaced by the text of an alias if 
an alias for this word has been defined. The first character of an alias 
name can be any non-special printable character, but the rest of the 
characters must be the same as for a valid identifier. The replacement 
string can contain any valid Shell script including the metacharacters 
listed above. The first word of each command in the replaced text, 
other than any that are in the process of being replaced, will be tested 
for aliases. If the last character of the alias value is a blank then the 
word following the alias will also be checked for alias substitution. 
Aliases can be used to redefine special built-in commands but cannot 
be used to redefine the reserved words listed above. Aliases can be 
created, listed, and exported with the alias command and can be 
removed with the unalias command. Exported aliases remain in effect 
for scripts invoked by name, but must be reinitialized for separate 
invocations of the Shell (See Invocation below). 

Aliasing is performed when scripts are read, not while they are exe¬ 
cuted. Therefore, for an alias to take effect the alias definition com¬ 
mand has to be executed before the command which references the 
alias is read. 

Aliases are frequently used as a shorthand for full path names. An 
option to the aliasing facility allows the value of the alias to be auto¬ 
matically set to the full pathname of the corresponding command. 
These aliases are called tracked aliases. The value of a tracked alias 
is defined the first time the corresponding command is looked up and 
becomes undefined each time the PATH variable is reset. These 
aliases remain tracked so that the next subsequent reference will 
redefine the value. Several tracked aliases are compiled into the shell. 
The -h option of the set command makes each referenced command 
name into a tracked alias. 

The following exported aliases are compiled into the shell but can be 

auto!oad=Typeset -fu' 
false=let 0' 
functions^ Typeset -f 
hash='alias -t' 
history ='fc -1' 
integer= Typeset -i' 
nohup=Tiohup ' 
r=Tc -e 
true=Y 

type= "whence -v" 
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Tilde Substitution 

After alias substitution is performed, each word is checked to see if it 
begins with an unquoted If it does, then the word up to a / is 
checked to see if it matches a user name in the /etc/passwd file. If a 
match is found, the ~ and the matched login name is replaced by the 
login directory of the matched user. This is called a tilde substitution. 
If no match is found, the original text is left unchanged. A - by itself, 
or in front of a /, is replaced by the value of the HOME parameter. A 
~ followed by a + or - is replaced by $PWD and $OLDPWD respec¬ 
tively. 

In addition, tilde substitution is attempted when the value of a vari¬ 
able assignment parameter begins with a —. 

Command Substitution 

The standard output from a command enclosed in parenthesis pre¬ 
ceded by a dollar sign ( $() ) or a pair of grave accents (") may be 
used as part or all of a word; trailing new-lines are removed. In the 
second (archaic) form, the string between the quotes is processed for 
special quoting characters before the command is executed. (See 
Quoting below). The command substitution $(cat file) can be 
replaced by the equivalent but faster $(<file). Command substitution 
of most special commands that do not perform input/output redirection 
are carried out without creating a separate process. 

An arithmetic expression enclosed in double parenthesis preceded by 
a dollar sign ($(())) is replaced by the value of the arithmetic expres¬ 
sion within the double parenthesis. 

Parameter Substitution 

A parameter is an identifier, one or more digits, or any of the charac¬ 
ters *, <3>, #, ?, -, $, and !. A named parameter (a parameter denoted 
by an identifier) has a value and zero or more attributes. Named 
parameters can be assigned values and attributes by using the 
typeset special command. The attributes supported by the Shell are 
described later with the typeset special command. Exported parame¬ 
ters pass values and attributes to the environment. 

The shell supports a one-dimensional array facility. An element of an 
array parameter is referenced by a subscript. A subscript is denoted 
by a [, followed by an arithmetic expression (see Arithmetic evalua¬ 
tion below) followed by a ]. To assign values to an array, use set -A 
name value .... The value of all subscripts must be in the range of 0 
through 1023. Arrays need not be declared. Any reference to a named 
parameter with a valid subscript is legal and an array will be created if 
necessary. Referencing an array without a subscript is equivalent to 
referencing the element zero. 
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The value of a named parameter may also be assigned by writing: 
name=value [ name rvalue ]... 

If the integer attribute, -i, is set for name the value is subject to arith¬ 
metic evaluation as described below. 

Positional parameters, parameters denoted by a number, may be 
assigned values with the set special command. Parameter $0 is set 
from argument zero when the shell is invoked. 

The character $ is used to introduce substitutable parameters. 

${ parameter } 

The shell reads all the characters from ${ to the matching } as part 
of the same word even if it contains braces or metacharacters. The 
value, if any, of the parameter is substituted. The braces are 
required when parameter is followed by a letter, digit, or under¬ 
score that is not to be interpreted as part of its name or when a 
named parameter is subscripted. If parameter is one or more digits 
then it is a positional parameter. A positional parameter of more 
than one digit must be enclosed in braces. If parameter is * or @, 
then all the positional parameters, starting with $1, are substituted 
(separated by a field separator character). If an array identifier 
with subscript * or @ is used, then the value for each of the ele¬ 
ments is substituted (separated by a field separator character). 
%{#parameter} 

If parameter is * or @, the number of positional parameters is sub¬ 
stituted. Otherwise, the length of the value of the parameter is 
substituted. 

${#identifier[*]} 

The number of elements in the array identifier is substituted. 

${parameter :-word} 

If parameter is set and is non-null then substitute its value; other¬ 
wise substitute word. 

%{parameter :=word} 

If parameter is not set or is null then set it to word ; the value of 
the parameter is then substituted. Positional parameters may not 
be assigned to in this way. 

${parameter :?word} 

If parameter is set and is non-null then substitute its value; other¬ 
wise, print word and exit from the shell. If word is omitted then a 
standard message is printed. 

${parameter :+word] 

If parameter is set and is non-null then substitute word\ otherwise 
substitute nothing. 

^{parameter ^pattern } 

^{parameter ^pattern } 

If the Shell pattern matches the beginning of the value of parame¬ 
ter , then the value of this substitution is the value of the parameter 
with the matched portion deleted; otherwise the value of this 
parameter is substituted. In the first form the smallest matching 
pattern is deleted and in the second form the largest matching pat¬ 
tern is deleted. 
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${parameter % pattern } 

${parameter % % pattern } 

If the Shell pattern matches the end of the value of parameter , 
then the value of this substitution is the value of the parameter 
with the matched part deleted; otherwise substitute the value of 
parameter. In the first form the smallest matching pattern is 
deleted and in the second form the largest matching pattern is 
deleted. 

In the above, word is not evaluated unless it is to be used as the substi¬ 
tuted string, so that, in the following example, pwd is executed only if 
d is not set or is null: 

echo ${d:-$(pwd)} 

If the colon (:) is omitted from the above expressions, then the shell 
only checks whether parameter is set or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

- Flags supplied to the shell on invocation or by the set com¬ 
mand. 

? The decimal value returned by the last executed command. 

$ The process number of this shell. 

Initially, the value _ is an absolute pathname of the shell or 
script being executed as passed in the environment . Subse¬ 
quently it is assigned the last argument of the previous com¬ 
mand. This parameter is not set for commands which are asyn¬ 
chronous. This parameter is also used to hold the name of the 
matching MAIL file when checking for mail. 

! The process number of the last background command invoked. 
ERRNO 

The value of errno as set by the most recently failed system 
call. This value is system dependent and is intended for debug¬ 
ging purposes. 

LINENO 

The line number of the current line within the script or function 
being executed. 

OLDPWD 

The previous working directory set by the cd command. 

OPTARG 

The value of the last option argument processed by the getopts 
special command. 

OPTIND 

The index of the last option argument processed by the getopts 
special command. 
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PPID 

The process number of the parent of the shell. 

PWD 

The present working directory set by the cd command. 

RANDOM 

Each time this parameter is referenced, a random integer, uni¬ 
formly distributed between 0 and 32767, is generated. The 
sequence of random numbers can be initialized by assigning a 
numeric value to RANDOM. 

REPLY 

This parameter is set by the select statement and by the read 
special command when no arguments are supplied. 

SECONDS 

Each time this parameter is referenced, the number of seconds 
since shell invocation is returned. If this parameter is assigned 
a value, then the value returned upon reference will be the 
value that was assigned plus the number of seconds since the 
assignment. 

The following parameters are used by the shell: 

CDPATH 

The search path for the cd command. 

COLUMNS 

If this variable is set, the value is used to define the width of the 
edit window for the shell edit modes and for printing select 
lists. 

EDITOR 

If the value of this variable ends in emacs , gmacs, or vi and the 
VISUAL variable is not set, then the corresponding option (see 
Special Command set below) will be turned on. 

ENV 

If this parameter is set, then parameter substitution is per¬ 
formed on the value to generate the pathname of the script that 
will be executed when the shell is invoked. (See Invocation 
below.) This file is typically used for alias and function 
definitions. 

FCEDIT 

The default editor name for the fc command. 

FPATH 

The search path for function definitions. This path is searched 
when a function with the -u attribute is referenced and when a 
command is not found. If an executable file is found, then it is 
read and executed in the current environment. 

IFS 

Internal field separators, normally space, tab, and new-line that 
is used to separate command words which result from com¬ 
mand or parameter substitution and for separating words with 
the special command read. The first character of the IFS 
parameter is used to separate arguments for the "$*" substitu¬ 
tion (See Quoting below). 
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HISTFILE 

If this parameter is set when the shell is invoked, then the value 
is the pathname of the file that will be used to store the com¬ 
mand history. (See Command re-entry below.) 

HISTSIZE 

If this parameter is set when the shell is invoked, then the num¬ 
ber of previously entered commands that are accessible by this 
shell will be greater than or equal to this number. The default 
is 128. 

HOME 

The default argument (home directory) for the cd command. 
LINES 

If this variable is set, the value is used to determine the column 
length for printing select lists. Select lists will print vertically 
until about two-thirds of LINES lines are filled. 

MAIL 

If this parameter is set to the name of a mail file and the MAIL- 
PATH parameter is not set, then the shell informs the user of 
arrival of mail in the specified file. 

MAILCHECK 

This variable specifies how often (in seconds) the shell will 
check for changes in the modification time of any of the files 
specified by the MAILPATH or MAIL parameters. The default 
value is 600 seconds. When the time has elapsed the shell will 
check before issuing the next prompt. 

MAILPATH 

A colon (:) separated list of file names. If this parameter is set 
then the shell informs the user of any modifications to the 
specified files that have occurred within the last MAILCHECK 
seconds. Each file name can be followed by a ? and a message 
that will be printed. The message will undergo parameter sub¬ 
stitution with the parameter, $_ defined as the name of the file 
that has changed. The default message is you have mail in $_. 
PATH 

The search path for commands (see Execution below). The 
user may not change PATH if executing under rksh (except in 
.profile ). 

PS1 

The value of this parameter is expanded for parameter substitu¬ 
tion to define the primary prompt string which by default is “$ 
The character ! in the primary prompt string is replaced by 
the command number (see Command Re-entiy below). 

PS2 

Secondary prompt string, by default “> 

PS3 

Selection prompt string used within a select loop, by default 
PS4 

The value of this parameter is expanded for parameter substitu¬ 
tion and precedes each line of an execution trace. If omitted, 
the execution trace prompt is “+ 
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SHELL 

The pathname of the shell is kept in the environment. At invo¬ 
cation, if the basename of this variable matches the pattern 
*r*sh, then the shell becomes restricted. 

TMOUT 

If set to a value greater than zero, the shell will terminate if a 
command is not entered within the prescribed number of 
seconds after issuing the PS1 prompt. (Note that the shell can 
be compiled with a maximum bound for this value which can¬ 
not be exceeded.) 

VISUAL 

If the value of this variable ends in emacs , gmacs , or v/ then the 
corresponding option (see Special Command set below) will be 
turned on. 

The shell gives default values to PATH, PS1, PS2, MAILCHECK, 
TMOUT and IFS, while HOME, SHELL ENV and MAIL are not set at 
all by the shell (although HOME is set by login ( M)). On some sys¬ 
tems MAIL and SHELL are also set by login( M)). 


Blank Interpretation 

After parameter and command substitution, the results of substitutions 
are scanned for the field separator characters (those found in IFS ) and 
split into distinct arguments where such characters are found. Explicit 
null arguments (" " or ") are retained. Implicit null arguments (those 
resulting from parameters that have no values) are removed. 


File Name Generation 

Following substitution, each command word is scanned for the char¬ 
acters *, ?, and [ unless the -f option has been set. If one of these 
characters appears then the word is regarded as a pattern . The word is 
replaced with lexicographically sorted file names that match the pat¬ 
tern. If no file name is found that matches the pattern, then the word is 
left unchanged. When a pattern is used for file name generation, the 
character . at the start of a file name or immediately following a /, as 
well as the character / itself, must be matched explicitly. In other 
instances of pattern matching the / and . are not treated specially. 

* Matches any string, including the null string. 

? Matches any single character. 

[...] 

Matches any one of the enclosed characters. A pair of charac¬ 
ters separated by - matches any character lexically between the 
pair, inclusive. If the first character following the opening "[ ” 
is a "! " then any character not enclosed is matched. A - can be 
included in the character set by putting it as the first or last 
character. 
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A pattern-list is a list of one or more patterns separated from each 
other with a |. Composite patterns can be formed with one or more of 
the following: 

? (pattern-list) 

Optionally matches any one of the given patterns. 

* (pattern-list) 

Matches zero or more occurrences of the given patterns. 

+( pattern-list) 

Matches one or more occurrences of the given patterns. 
@(pattern-list) 

Matches exactly one of the given patterns. 

!( pattern-list) 

Matches anything, except one of the given patterns. 


Quoting 

Each of the metacharacters listed above (See Definitions above) has a 
special meaning to the shell and causes termination of a word unless 
quoted. A character may be quoted (i.e., made to stand for itself) by 
preceding it with a \. The pair \new-line is ignored. All characters 
enclosed between a pair of single quote marks (")» af e quoted. A sin¬ 
gle quote cannot appear within single quotes. Inside double quote 
marks (""), parameter and command substitution occurs and \ quotes 
the characters \, \ ”, and $. The meaning of $* and $@ is identical 
when not quoted or when used as a parameter assignment value or as a 
file name. However, when used as a command argument, "$*" is 
equivalent to "$ld$2d.. ”, where d is the first character of the IFS 
parameter, whereas ”$@” is equivalent to "$1” ”$2” .... Inside 
grave quote marks ( vv ) \ quotes the characters \, v , and $. If the grave 
quotes occur within double quotes then \ also quotes the character ". 

The special meaning of reserved words or aliases can be removed by 
quoting any character of the reserved word. The recognition of func¬ 
tion names or special command names listed below cannot be altered 
by quoting them. 


Arithmetic Evaluation 

An ability to perform integer arithmetic is provided with the special 
command let. Evaluations are performed using long arithmetic. Con¬ 
stants are of the form [base#]n where base is a decimal number 
between two and thirty-six representing the arithmetic base and n is a 
number in that base. If base is omitted then base 10 is used. 

An arithmetic expression uses the same syntax, precedence, and asso¬ 
ciativity of expression of the C language. All die integral operators, 
other than ++, ?:, and , are supported. Named parameters can be 

referenced by name within an arithmetic expression without using the 
parameter substitution syntax. When a named parameter is refer¬ 
enced, its value is evaluated as an arithmetic expression. 
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An internal integer representation of a named parameter can be 
specified with the -i option of the typeset special command. Arith¬ 
metic evaluation is performed on the value of each assignment to a 
named parameter with the -i attribute. If you do not specify an arith¬ 
metic base, the first assignment to the parameter determines the arith¬ 
metic base. This base is used when parameter substitution occurs. 

Since many of the arithmetic operators require quoting, an alternative 
form of the let command is provided. For any command which begins 
with a ((, all the characters until a matching )) are treated as a quoted 
expression. More precisely, ((...)) is equivalent to let " .. 


Prompting 

When used interactively, the shell prompts with the value of PS1 
before reading a command. If at any time a new-line is typed and 
further input is needed to complete a command, then the secondary 
prompt (i.e., the value of PS2) is issued. 


Conditional Expressions 

A conditional expression is used with the [[ compound command to 
test attributes of files and to compare strings. Word splitting and file 
name generation are not performed on the words between [[ and ]]. 
Each expression can be constructed from one or more of the following 
unary or binary expressions: 

-a file 

True, if file exists. 

■b file 

True, if file exists and is a block special file. 

-c file 

True, if file exists and is a character special file. 

-dfile 

True, if file exists and is a directory. 

-f file 

True, if file exists and is an ordinary file. 

-g file 

True, if file exists and is has its setgid bit set. 

-k file 

True, if file exists and is has its sticky bit set. 

-n string 

True, if length of string is non-zero. 

-o option 

True, if option named option is on. 

■pfile 

True, if file exists and is a fifo special file or a pipe. 

-r file 

True, if file exists and is readable by current process. 
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-s file 

True, if file exists and has size greater than zero. 

-t fildes 

True, if file descriptor number fildes is open and associated with a 
terminal device. 

-u file 

True, if file exists and is has its setuid bit set. 

-w file 

True, if file exists and is writable by current process. 
xfile 

True, if file exists and is executable by current process. If file 
exists and is a directory, then the current process has permission to 
search in the directory. 

-z string 

True, if length of string is zero. 

■O file 

True, if file exists and is owned by the effective user id of this pro¬ 
cess. 

-G file 

True, if file exists and its group matches the effective group id of 
this process. 
filel -nt file2 

True, if filel exists and is newer than file2 . 
filel -ot file2 

True, if filel exists and is older than file2 . 
filel -ef file2 

True, if filel and file2 exist and refer to the same file. 
string = pattern 

True, if string matches pattern . 
string != pattern 

True, if string does not match pattern . 
stringl < string2 

True, if stringl comes before string2 based on ASCII value of their 
characters. 
stringl > string2 

True, if stringl comes after string2 based on ASCII value of their 
characters. 
expl -eq exp2 

True, if expl is equal to exp2. 
expl -ne exp2 

True, if expl is not equal to exp2. 
expl -It exp2 

True, if expl is less than exp2. 
expl -gt exp2 

True, if expl is greater than exp2. 
expl -le exp2 

True, if expl is less than or equal to exp2. 
expl -ge exp2 

True, if expl is greater than or equal to exp2. 
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In each of the above expressions, if file is of the form /dev/fd/rc, where 
n is an integer, then the test is applied to the open file whose descrip¬ 
tor number is n . 

A compound expression can be constructed from these primitives by 
using any of the following, listed in decreasing order of precedence. 

( expression ) 

True, if expression is true. Used to group expressions. 

! expression 

True if expression is false. 
expressionl && expression2 

True, if expressionl and expression 2 are both true. 
expressionl 11 expression2 

True, if either expressionl or expression 2 is true. 


Spelling Checker 

By default, the shell checks spelling whenever you use cd to change 
directories. For example, if you change to a different directory using 
cd and misspell the directory name, the shell responds with an alterna¬ 
tive spelling of an existing directory. Enter “y” and press RETURN 
(or just press RETURN) to change to the offered directory. If the 
offered spelling is incorrect, enter “n”, then retype the command line. 
In this example the ksh response is boldfaced: 

# cd /usr/spol/uucp 
/usr/spool/uucp? y 
ok 

The spell check feature is controlled by the CDSPELL environment 
variable. The default value of CDSPELL is set to the string “cdspell” 
whenever a ksh session is run. A user can change it to any value, 
including the null string, but the value is immaterial: if CDSPELL is 
set to any value, the spell check feature is engaged. 

To disable the spelling checker, enter the following at the ksh prompt: 

unset CDSPELL 

When the user does a set at the ksh prompt, CDSPELL is not listed if 
the unset was successful. 


Input/Output 

Before a command is executed, its input and output may be redirected 
using a special notation interpreted by the shell. The following may 
appear anywhere in a simple-command or may precede or follow a 
command and are not passed on to the invoked command. Command 
and parameter substitution occurs before word or digit is used except 
as noted below. File name generation occurs only if the pattern 
matches a single file and blank interpretation is not performed. 
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<word 

Use file word as standard input (file descriptor 0). 

>word 

Use file word as standard output (file descriptor 1). 
If the file does not exist then it is created. If the file 
exists, and the noclobber option is on, this causes an 
error; otherwise, it is truncated to zero length. 

>| word 

Sames as >, except that it overrides the noclobber 
option. 

»word 

Use file word as standard output. If the file exists 
then output is appended to it (by first seeking to the 
end-of-file); otherwise, the file is created. 

oword 

Open file word for reading as standard input and 
writing as standard output. 

«[-]word 

The shell input is read up to a line that is the same as 
word , or to an end-of-file. No parameter substitu¬ 
tion, command substitution or file name generation is 
performed on word. The resulting document, called 
a here-document , becomes the standard input. If any 
character of word is quoted, then no interpretation is 
placed upon the characters of the document; other¬ 
wise, parameter and command substitution occurs, 
\new-line is ignored, and \ must be used to quote the 
characters \, $, \ and the first character of word. If - 
is appended to «, then all leading tabs are stripped 
from word and from the document. 

<&digit 

The standard input is duplicated from file descriptor 
digit (see dup( S)). Similarly for the standard output 
using >& digit. 

<&- 

The standard input is closed. Similarly for the stan¬ 
dard output using >&-. 

<&p 

The input from the co-process is moved to standard 
input. 

>&p 

The output to the co-process is moved to standard 
output. 


If one of the above is preceded by a digit, then the file descriptor num¬ 
ber referred to is that specified by the digit (instead of the default 0 or 
1). For example: 

... 2>&1 

means file descriptor 2 is to be opened for writing as a duplicate of file 
descriptor 1. 
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The order in which redirections are specified is significant. The shell 
evaluates each redirection in terms of the (file descriptor , file) associ¬ 
ation at the time of evaluation. For example: 

... 1 >fname 2>&1 

first associates file descriptor 1 with file fname . It then associates file 
descriptor 2 with the file associated with file descriptor 1 (i.e. fname ). 
If the order of redirections were reversed, file descriptor 2 would be 
associated with the terminal (assuming file descriptor 1 had been) and 
then file descriptor 1 would be associated with fil t fname . 

If a command is followed by & and job control is not active, then the 
default standard input for the command is the empty file /dev/null. 
Otherwise, the environment for the execution of a command contains 
the file descriptors of the invoking shell as modified by input/output 
specifications. 


Environment 

The environment (see environ (M)) is a list of name-value pairs that is 
passed to an executed program in the same way as a normal argument 
list. The names must be identifiers and the values are character 
strings. The shell interacts with the environment in several ways. On 
invocation, the shell scans the environment and creates a parameter 
for each name found, giving it the corresponding value and marking it 
export . Executed commands inherit the environment. If the user 
modifies the values of these parameters or creates new ones, using the 
export or typeset -x commands they become part of the environment. 
The environment seen by any executed command is thus composed of 
any name-value pairs originally inherited by the shell, whose values 
may be modified by the current shell, plus any additions which must 
be noted in export or typeset -x commands. 

The environment for any simple-command or function may be aug¬ 
mented by prefixing it with one or more parameter assignments. A 
parameter assignment argument is a word of the form 
identifier=value . Thus: 

TERM=450 cmd args 

(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the -k flag is set, all parameter assignment arguments are placed in 
the environment, even if they occur after the command name. The fol¬ 
lowing first prints a=b c and then c: 

echo a=b c 
set -k 
echo a=b c 
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This feature is intended for use with scripts written for early versions 
of the shell and its use in new scripts is strongly discouraged. It is 
likely to disappear someday. 

Functions 

The function reserved word, described in the Commands section 
above, is used to define shell functions. Shell functions are read in 
and stored internally. Alias names are resolved when the function is 
read. Functions are executed like commands with the arguments 
passed as positional parameters. (See Execution below). 

Functions execute in the same process as the caller and share all files 
and present working directory with the caller. Traps caught by the 
caller are reset to their default action inside the function. A trap con¬ 
dition that is not caught or ignored by the function causes the function 
to terminate and the condition to be passed on to the caller. A trap on 
EXIT set inside a function is executed after the function completes in 
the environment of the caller. Ordinarily, variables are shared 
between the calling program and the function. However, the typeset 
special command used within a function defines local variables whose 
scope includes the current function and all functions it calls. 

The special command return is used to return from function calls. 
Errors within functions return control to the caller. 

Function identifiers can be listed with the -f or +f option of the typeset 
special command. The text of functions will also be listed with -f. 
Function can be undefined with the -f option of the unset special com¬ 
mand. 

Ordinarily, functions are unset when the shell executes a shell script. 
The -xf option of the typeset command allows a function to be 
exported to scripts that are executed without a separate invocation of 
the shell. Functions that need to be defined across separate invoca¬ 
tions of the shell should be specified in the ENV file with the -xf 
option of typeset 

Jobs 

If the monitor option of the set command is turned on, an interactive 
shell associates a job with each pipeline. It keeps a table of current 
jobs, printed by the jobs command, and assigns them small integer 
numbers. When a job is started asynchronously with &, the shell 
prints a line which looks like: 

[1] 1234 

indicating that the job which was started asynchronously was job 
number 1 and had one (top-level) process, whose process id was 1234. 
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This paragraph and the next require features that are not in all versions 
of the UNIX operating system and may not apply. If you are running a 
job and wish to do something else you may hit the key A Z (control-Z) 
which sends a STOP signal to the current job. The shell will then nor¬ 
mally indicate that the job has been ‘Stopped’, and print another 
prompt. You can then manipulate the state of this job, putting it in the 
background with the bg command, or run some other commands and 
then eventually bring the job back into the foreground with the fore¬ 
ground command fg. A A Z takes effect immediately and is like an 
interrupt in that pending output and unread input are discarded when it 
is typed. 

A job being run in the background will stop if it tries to read from the 
terminal. Background jobs are normally allowed to produce output, 
but this can be disabled by giving the command “stty tostop”. If you 
set this tty option, then background jobs will stop when they try to 
produce output like they do when they try to read input. 

There are several ways to refer to jobs in the shell. A job can be 
referred to by the process id of any process of the job or by one of the 
following: 

% number 

The job with the given number. 

% string 

Any job whose command line begins with string. 

%? string 

Any job whose command line contains string . 

%% 

Current job. 

%+ 

Equivalent to %%. 

%- 

Previous job. 

This shell learns immediately whenever a process changes state. It 
normally informs you whenever a job becomes blocked so that no 
further progress is possible, but only just before it prints a prompt. 
This is done so that it does not otherwise disturb your work. 

When the monitor mode is on, each background job that completes 
triggers any trap set for SIGCLD. 

When you try to leave the shell while jobs are running or stopped, you 
will be warned that ‘You have stopped(running) jobs.’ You may use 
the jobs command to see what they are. If you do this or immediately 
try to exit again, the shell will not warn you a second time, and the 
stopped jobs will be terminated. 
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Signals 

The INT and QUIT signals for an invoked command are ignored if the 
command is followed by & and job monitor option is not active. Oth¬ 
erwise, signals have the values inherited by the shell from its parent 
(but see also the trap command below). 


Execution 

Each time a command is executed, the above substitutions are carried 
out. If the command name matches one of the Special Commands 
listed below, it is executed within the current shell process. Next, the 
command name is checked to see if it matches one of the user defined 
functions. If it does, the positional parameters are saved and then 
reset to the arguments of the function call. When the function com¬ 
pletes or issues a return, the positional parameter list is restored and 
any trap set on EXIT within the function is executed. The value of a 
function is the value of the last command executed. A function is also 
executed in the current shell process. If a command name is not a spe¬ 
cial command or a user defined function , a process is created and an 
attempt is made to execute the command via exec( S). 

The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are separated 
by a colon (:). The default path is /bin:/usr/bin: (specifying /bin, 
/usr/bin, and the current directory in that order). The current direc¬ 
tory can be specified by two or more adjacent colons, or by a colon at 
the beginning or end of the path list. If the command name contains a 
/ then the search path is not used. Otherwise, each directory in the 
path is searched for an executable file. If the file has execute permis¬ 
sion but is not a directory or an a.out file, it is assumed to be a file 
containing shell commands. A sub-shell is spawned to read it. All 
non-exported aliases, functions, and named parameters are removed in 
this case. If the shell command file doesn’t have read permission, or if 
the setuid and/or setgid bits are set on the file, then the shell executes 
an agent whose job it is to set up the permissions and execute the shell 
with the shell command file passed down as an open file. A 
parenthesized command is executed in a sub-shell without removing 
non-exported quantities. 


Command Re-entry 

The text of the last HISTSIZE (default 128) commands entered from a 
terminal device is saved in a history file. The file $HOME/.sh_history 
is used if the HISTFILE variable is not set or is not writable. A shell 
can access the commands of all interactive shells which use the same 
named HISTFILE. The special command fc is used to list or edit a 
portion of this file. The portion of the file to be edited or listed can be 
selected by number or by giving the first character or characters of the 
command. A single command or range of commands can be specified. 
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If you do not specify an editor program as an argument to fc then the 
value of the parameter FCEDIT is used. If FCEDIT is not defined then 
/bin/ed is used. The edited command(s) is printed and re-executed 
upon leaving the editor. The editor name - is used to skip the editing 
phase and to re-execute the command. In this case a substitution 
parameter of the form old=new can be used to modify the command 
before execution. For example, if r is aliased to 'fc -e then typing ‘r 
bad=good c’ will re-execute the most recent command which starts 
with the letter c, replacing the first occurrence of the string bad with 
the string good. 


In-line Editing Options 

Normally, each command line entered from a terminal device is sim¬ 
ply typed followed by a new-line (‘RETURN’ or ‘LINEFEED’). If 
either the emacs, gmacs, or vi option is active, the user can edit the 
command line. To be in either of these edit modes set the corre¬ 
sponding option. An editing option is automatically selected each 
time the VISUAL or EDITOR variable is assigned a value ending in 
either of these option names. 

The editing features require that the user’s terminal accept ‘RETURN’ 
as carriage return without line feed and that a space (‘ ’) must 
overwrite the current character on the screen. ADM terminal users 
should set the "space - advance" switch to ‘space’. Hewlett-Packard 
series 2621 terminal users should set the straps to ‘bcGHxZ etX’. 

The editing modes implement a concept where the user is looking 
through a window at the current line. The window width is the value 
of COLUMNS if it is defined, otherwise 80. If the line is longer than 
the window width minus two, a mark is displayed at the end of the 
window to notify the user. As the cursor moves and reaches the win¬ 
dow boundaries the window will be centered about the cursor. The 
mark is a > (<, *) if the line extends on the right (left, both) side(s) of 
the window. 

The search commands in each edit mode provide access to the history 
file. Only strings are matched, not patterns, although a leading A in the 
string restricts the match to begin at the first character in the line. 


Emacs Editing Mode 

This mode is entered by enabling either the emacs or gmacs option. 
The only difference between these two modes is the way they handle 
A T. To edit, the user moves the cursor to the point needing correction 
and then inserts or deletes characters or words as needed. All the edit¬ 
ing commands are control characters or escape sequences. The nota¬ 
tion for control characters is caret ( A ) followed by the character. For 
example, A F is the notation for control F. This is entered by depress¬ 
ing T while holding down the ‘CTRL’ (control) key. The ‘SHIFT’ 
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key is not depressed. (The notation A ? indicates the DEL (delete) 
key.) 

The notation for escape sequences is M- followed by a character. For 
example, M-f (pronounced Meta f) is entered by depressing ESC (ascii 
033) followed by ‘f’. (M-F would be the notation for ESC followed by 
‘SHIFT’ (capital) ‘F’.) 

All edit commands operate from any place on the line (not just at the 
beginning). Neither the "RETURN” nor the "LINE FEED" key is 
entered after edit commands except when noted. 

T Move cursor forward (right) one character. 

M-f Move cursor forward one word. (The emacs editor’s idea 

of a word is a string of characters consisting of only 
letters, digits and underscores.) 

Move cursor backward (left) one character. 

M-b Move cursor backward one word. 

"A Move cursor to start of line. 

A E Move cursor to end of line. 

*]char Move cursor forward to character char on current line. 
M-*]char Move cursor back to character char on current line. 

X X Interchange the cursor and mark. 

erase (User defined erase character as defined by the stty(C ) 
command, usually A H or #.) Delete previous character. 

"D Delete current character. 

M-d Delete current word. 

M- A H (Meta-backspace) Delete previous word. 

M-h Delete previous word. 

M- A ? (Meta-DEL) Delete previous word (if your interrupt char¬ 
acter is A ? (DEL, the default) then this command will not 
work). 

A T Transpose current character with next character in emacs 

mode. Transpose two previous characters in gmacs mode. 
A C Capitalize current character. 

M-c Capitalize current word. 

M-l Change the current word to lower case. 

A K Delete from the cursor to the end of the line. If preceded 

by a numerical parameter whose value is less than the 
current cursor position, then delete from given position up 
to the cursor. If preceded by a numerical parameter 
whose value is greater than the current cursor position, 
then delete from cursor up to given cursor position. 

W Kill from the cursor to the mark. 

M-p Push the region from the cursor to the mark on the stack. 

kill (User defined kill character as defined by the stty com¬ 

mand, usually A G or @.) Kill the entire current line. If 
two kill characters are entered in succession, all kill char¬ 
acters from then on cause a line feed (useful when using 
paper terminals). 
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A Y Restore last item removed from line. (Yank item back to 

the line.) 

X Line feed and print current line. 

A @ (Null character) Set mark. 

M-space (Meta space) Set mark. 

A J (New line) Execute the current line. 

A M (Return) Execute the current line. 

eof End-of-file character, normally A D, is processed as an 

End-of-file only if the current line is null. 

A P Fetch previous command. Each time A P is entered the 

previous command back in time is accessed. Moves back 
one line when not on the first line of a multi-line com¬ 
mand. 

M-< Fetch the least recent (oldest) history line. 

M-> Fetch the most recent (youngest) history line. 

A N Fetch next command line. Each time A N is entered the 

next command line forward in time is accessed. 

A R string Reverse search history for a previous command line con¬ 

taining string. If a parameter of zero is given, the search 
is forward. String is terminated by a "RETURN” or 
"NEW LINE". If string is preceded by a A , the matched 
line must begin with string . If string is omitted, then the 
next command line containing the most recent string is 
accessed. In this case a parameter of zero reverses the 
direction of the search. 

A 0 Operate - Execute the current line and fetch the next line 

relative to current line from the history file. 

M -digits (Escape) Define numeric parameter, the digits are taken 
as a parameter to the next command. The commands that 
accept a parameter are A F, A B, erase , A C, D, K, R, A P, 
N, ], M-., M- ], M-_, M-b, M-c, M-d, M-f, M-h M-l and 
M-H. 

M -letter Soft-key - Your alias list is searched for an alias by the 

name Jetter and if an alias of this name is defined, its 
value will be inserted on the input queue. The letter must 
not be one of the above meta-functions. M -]letter Soft- 
key - Your alias list is searched for an alias by the name 
Jetter and if an alias of this name is defined, its value 
will be inserted on the input queue. This can be used to 
program functions keys on many terminals. 

M-. The last word of the previous command is inserted on the 

line. If preceded by a numeric parameter, the value of 
this parameter determines which word to insert rather 
than the last word. 

M-_ Same as M-.. 

M-* Attempt file name generation on the current word. An 

asterisk is appended if the word doesn’t match any file or 
contain any special pattern characters. 
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M-ESC File name completion. Replaces the current word with 
the longest common prefix of all filenames matching the 
current word with an asterisk appended. If the match is 
unique, a / is appended if the file is a directory and a space 
is appended if the file is not a directory. 

M-= List files matching current word pattern if an asterisk 

were appended. 

A U Multiply parameter of next command by 4. 

\ Escape next character. Editing characters, the user’s 

erase, kill and interrupt (normally *?) characters may be 
entered in a command line or in a search string if pre¬ 
ceded by a \. The \ removes the next character’s editing 
features (if any). 

A V Display version of the shell. 

M-# Insert a # at the beginning of the line and execute it. This 

causes a comment to be inserted in the history file. 


Vi Editing Mode 

There are two typing modes. Initially, when you enter a command you 
are in the input mode. To edit, the user enters control mode by typing 
ESC ( 033 ) and moves the cursor to the point needing correction and 
then inserts or deletes characters or words as needed. Most control 
commands accept an optional repeat count prior to the command. 

When in vi mode on most systems, canonical processing is initially 
enabled and the command will be echoed again if the speed is 1200 
baud or greater and it contains any control characters or less than one 
second has elapsed since the prompt was printed. The ESC character 
terminates canonical processing for the remainder of the command 
and the user can then modify the command line. This scheme has the 
advantages of canonical processing with the type-ahead echoing of 
raw mode. 

If the option viraw is also set, the terminal will always have canonical 
processing disabled. This mode is implicit for systems that do not 
support two alternate end of line delimiters, and may be helpful for 
certain terminals. 


Input Edit Commands 

By default the editor is in input mode. 

erase (User defined erase character as defined by the stty 
command, usually A H or #.) Delete previous character. 

*W Delete the previous blank separated word. 

*D Terminate the shell. 

"V Escape next character. Editing characters, the user’s 

erase or kill characters may be entered in a command 
line or in a search string if preceded by a "V. The "V 
removes the next character’s editing features (if any). 

\ Escape the next erase or kill character. 
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Motion Edit Commands 

These commands will move the cursor. 

[count] 1 Cursor forward (right) one character. 

[count]w Cursor forward one alpha-numeric word. 

[count ]W Cursor to the beginning of the next word that follows a 
blank. 

[count]e Cursor to end of word. 

[count ]E Cursor to end of the current blank delimited word. 
[count ]h Cursor backward (left) one character. 

[count]b Cursor backward one word. 

[count ]B Cursor to preceding blank separated word. 

[count] | Cursor to column count. 

[count]ic Find the next character c in the current line. 

[count]Fc Find the previous character c in the current line. 
[count]tc Equivalent to f followed by h. 

[count]Tc Equivalent to F followed by I. 

[count]; Repeats count times, the last single character find 
command, f, F, t, or T. 

[count], Reverses the last single character find command count 
times. 

0 Cursor to start of line. 

Cursor to first non-blank character in line. 

$ Cursor to end of line. 

Search Edit Commands 


These commands access your command history. 


[count] k 

[count]- 
[count ]j 

[count]+ 
[count] G 

Istring 


?string 


N 


Fetch previous command. Each time k is entered the 
previous command back in time is accessed. 

Equivalent to k. 

Fetch next command. Each time j is entered the next 
command forward in time is accessed. 

Equivalent to j. 

The command number count is fetched. The default is 
the least recent history command. 

Search backward through history for a previous com¬ 
mand containing string. String is terminated by a 
"RETURN” or "NEW LINE". If string is preceded by 
a ", the matched line must begin with string . If string 
is null the previous string will be used. 

Same as / except that search will be in the forward 
direction. 

Search for next match of the last pattern to / or ? com¬ 
mands. 

Search for next match of the last pattern to / or ?, but 
in reverse direction. Search history for the string 
entered by the previous / command. 
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Text Modification Edit Commands 

These commands will modify the line. 

a Enter input mode and enter text after the current char¬ 

acter. 

A Append text to the end of the line. Equivalent to $a. 

\count]cmotion 

c[couni]motion 

Delete current character through the character that 
motion would move the cursor to and enter input 
mode. If motion is c, the entire line will be deleted 
and input mode entered. 

C Delete the current character through the end of line 

and enter input mode. Equivalent to c$. 

S Equivalent to cc. 

D Delete the current character through the end of line. 

Equivalent to d$. 

[count]dmotion 

d[count]motion 

Delete current character through the character that 
motion would move to. If motion is d , the entire line 
will be deleted. 

Enter input mode and insert text before the current 
character. 

Insert text before the beginning of the line. Equivalent 
to Oi. 

Place the previous text modification before the cursor. 
Place the previous text modification after the cursor. 
Enter input mode and replace characters on the screen 
with characters you type overlay fashion. 

Replace the count character(s) starting at the current 
cursor position with c , and advance the cursor. 

Delete current character. 

Delete preceding character. 

Repeat the previous text modification command. 

Invert the case of the count character(s) starting at the 
current cursor position and advance the cursor. 

Causes the count word of the previous command to be 
appended and input mode entered. The last word is 
used if count is omitted. 

Causes an * to be appended to the current word and 
file name generation attempted. If no match is found, 
it rings the bell. Otherwise, the word is replaced by 
the matching pattern and input mode is entered. 
Filename completion. Replaces the current word with 
the longest common prefix of all filenames matching 
the current word with an asterisk appended. If the 
match is unique, a / is appended if the file is a direc¬ 
tory and a space is appended if the file is not a direc¬ 
tory. 


I 

[count] P 
[count] p 

R 

[count]vc 

[count]\ 

[count]X 

[count], 

[count]- 

[count]_ 


* 


\ 
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Other Edit Commands 

Miscellaneous commands. 

\count]ymotion 

y[count]motion 

Yank current character through character that motion 
would move the cursor to and puts them into the delete 
buffer. The text and cursor are unchanged. 

Y Yanks from current position to end of line. Equivalent 

to y$. 

u Undo the last text modifying command. 

U Undo all the text modifying commands performed on 

the line. 

[count]\ Returns the command fc -e 

${VISUAL:-${EDITO R : - vi} } count in the input buffer. 
If count is omitted, then the current line is used. 

*L Line feed and print current line. Has effect only in 

control mode. 

M (New line) Execute the current line, regardless of 

mode. 

"M (Return) Execute the current line, regardless of mode. 

# Sends the line after inserting a # in front of the line. 

Useful for causing the current line to be inserted in the 
history without being executed. 

= List the file names that match the current word if an 

asterisk were appended it. 

@letter Your alias list is searched for an alias by the name 
Jetter and if an alias of this name is defined, its value 
will be inserted on the input queue for processing. 


Special Commands. 

The following simple-commands are executed in the shell process. 
Input/Output redirection is permitted. Unless otherwise indicated, the 
output is written on file descriptor 1 and the exit status, when there is 
no syntax error, is zero. Commands that are preceded by one or two f 
are treated specially in the following ways: 

1. Parameter assignment lists preceding the command remain in 
effect when the command completes. 

2. I/O redirections are processed after parameter assignments. 

3. Errors cause a script that contains them to abort. 

4. Words, following a command preceded by tt that are in the format 
of a parameter assignment, are expanded with the same rules as a 
parameter assignment. This means that tilde substitution is per¬ 
formed after the = sign and word splitting and file name generation 
are not performed. 
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t: [ arg ... ] 

The command only expands parameters, 
t .file [arg ...] 

Read the complete file then execute the commands. The com¬ 
mands are executed in the current Shell environment. The search 
path specified by PATH is used to find the directory containing file. 
If any arguments arg are given, they become the positional param¬ 
eters. Otherwise the positional parameters are unchanged. The 
exit status is the exit status of the last command executed. 

ft alias [ -tx ] [ name[ rvalue ] ]... 

Alias with no arguments prints the list of aliases in the form 
name-value on standard output. An alias is defined for each name 
whose value is given. A trailing space in value causes the next 
word to be checked for alias substitution. The -t flag is used to set 
and list tracked aliases. The value of a tracked alias is the full 
pathname corresponding to the given name. The value becomes 
undefined when the value of PATH is reset but the aliases remained 
tracked. Without the -t flag, for each name in the argument list for 
which no value is given, the name and value of the alias is printed. 
The -x flag is used to set or print exported aliases. An exported 
alias is defined for scripts invoked by name. The exit status is 
non-zero if a name is given, but no value, for which no alias has 
been defined. 

bg [job... ] 

This command is only on systems that support job control. Puts 
each specified job into the background. The current job is put in 
the background if job is not specified. See Jobs for a description 
of the format of job. 

t break [ n ] 

Exit from the enclosing for while until or select loop, if any. If n 
is specified then break n levels. 

t continue [ n ] 

Resume the next iteration of the enclosing for while until or 
select loop. If n is specified then resume at the At-th enclosing 
loop. 

cd [ arg ] 
cd old new 

This command can be in either of two forms. In the first form it 
changes the current directory to arg. If arg is - the directory is 
changed to the previous directory. The shell parameter HOME is 
the default arg. The parameter PWD is set to the current directory. 
The shell parameter CDPATH defines the search path for the direc¬ 
tory containing arg. Alternative directory names are separated by 
a colon (:). The default path is <null> (specifying the current 
directory). Note that the current directory is specified by a null 
path name, which can appear immediately after the equal sign or 
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between the colon delimiters anywhere else in the path list. If arg 
begins with a / then the search path is not used. Otherwise, each 
directory in the path is searched for arg. 

The second form of cd substitutes the string new for the string old 
in the current directory name, PWD and tries to change to this new 
directory. 

The cd command may not be executed by rksh. 
echo [ arg ... ] 

See echo( C) for usage and description, 
t eval [ arg ... ] 

The arguments are read as input to the shell and the resulting 
command(s) executed. 

t exec [ arg ... ] 

If arg is given, the command specified by the arguments is exe¬ 
cuted in place of this shell without creating a new process. 
Input/output arguments may appear and affect the current process. 
If no arguments are given the effect of this command is to modify 
file descriptors as prescribed by the input/output redirection list. In 
this case, any file descriptor numbers greater than 2 that are opened 
with this mechanism are closed when invoking another program. 

t exit [ n ] 

Causes the shell to exit with the exit status specified by n. If n is 
omitted then the exit status is that of the last command executed. 
An end-of-file will also cause the shell to exit except for a shell 
which has the ignoreeof option (see set below) turned on. 

ft export [ name[ rvalue ] ]... 

The given name s are marked for automatic export to the environ¬ 
ment of subsequently-executed commands. 

fc[-e ename ] [ -nlr ] [ first [ last ] ] 
fc -e - [ old-new ] [ command ] 

In the first form, a range of commands from first to last is selected 
from the last HISTSIZE commands that were typed at the terminal. 
The arguments first and last may be specified as a number or as a 
string. A string is used to locate the most recent command starting 
with the given string. A negative number is used as an offset to the 
current command number. If the flag -1, is selected, the commands 
are listed on standard output. Otherwise, the editor program 
ename is invoked on a file containing these keyboard commands. 
If ename is not supplied, then the value of the parameter FCEDIT 
(default /bin/ed) is used as the editor. When editing is complete, 
the edited command(s) is executed. If last is not specified then it 
will be set to first. If first is not specified the default is the previ¬ 
ous command for editing and -16 for listing. The flag -r reverses 
the order of the commands and the flag -n suppresses command 
numbers when listing. In the second form the command is re- 
executed after the substitution old=new is performed. 
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fg [job... ] 

This command is only on systems that support job control. Each 
job specified is brought to the foreground. Otherwise, the current 
job is brought into the foreground. See Jobs for a description of 
the format of job. 

getopts optstring name [ arg ... ] 

Checks arg for legal options. If arg is omitted, the positional 
parameters are used. An option argument begins with a + or a -. 
An option not beginning with + or - or the argument - - ends the 
options, optstring contains the letters that getopts recognizes. If a 
letter is followed by a :, that option is expected to have an argu¬ 
ment. The options can be separated from the argument by blanks, 
getopts places the next option letter it finds inside variable name 
each time it is invoked with a + prepended when arg begins with a 
+. The index of the next arg is stored in OPTIND. The option 
argument, if any, gets stored in OPTARG. 

A leading : in optstring causes getopts to store the letter of an 
invalid option in OPTARG, and to set name to ? for an unknown 
option and to : when a required option is missing. Otherwise, 
getopts prints an error message. The exit status is non-zero when 
there are no more options. 

jobs [ -lnp ] [ job ... ] 

Lists information about each given job; or all active jobs if job is 
omitted. The -I flag lists process ids in addition to the normal in¬ 
formation. The -n flag only displays jobs that have stopped or 
exited since last notified. The -p flag causes only the process 
group to be listed. See Jobs for a description of the format of job. 

kill [ -sig ]job ... 

kill -1 

Sends either the TERM (terminate) signal or the specified signal to 
the specified jobs or processes. Signals are either given by number 
or by names (as given in /usr/include/signal.h, stripped of the 
prefix “SIG”). If the signal being sent is TERM (terminate) or 
HUP (hangup), then the job or process will be sent a CONT (con¬ 
tinue) signal if it is stopped. The argument job can the process id 
of a process that is not a member of one of the active jobs. See 
Jobs for a description of the format of job. In the second form, kill 
- 1 , the signal numbers and names are listed. 

let arg ... 

Each arg is a separate arithmetic expression to be evaluated. See 
Arithmetic Evaluation above, for a description of arithmetic 
expression evaluation. 

The exit status is 0 if the value of the last expression is non-zero, 
and 1 otherwise. 

t newgrp [arg ... ] 

Equivalent to exec /bin/newgrp arg .... 
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print [ -Rnprsu[fl ] ] [ arg ... ] 

The shell output mechanism. With no flags or with flag - or - - the 
arguments are printed on standard output as described by echo{ C). 
In raw mode, -R or -r, the escape conventions of echo are ignored. 
The -R option will print all subsequent arguments and options 
other than -n. The -p option causes the arguments to be written 
onto the pipe of the process spawned with | & instead of standard 
output. The -s option causes the arguments to be written onto the 
history file instead of standard output. The -u flag can be used to 
specify a one digit file descriptor unit number n on which the out¬ 
put will be placed. The default is 1. If the flag -n is used, no new- 
line is added to the output. 

pwd 

Equivalent to print -r - $PWD 

read [ -prsu [ n ] ] [ name!prompt ] [ name ... ] 

The shell input mechanism. One line is read and is broken up into 
fields using the characters in IFS as separators. In raw mode, -r, a \ 
at the end of a line does not signify line continuation. The first 
field is assigned to the first name , the second field to the second 
name , etc., with leftover fields assigned to the last name. The -p 
option causes the input line to be taken from the input pipe of a 
process spawned by the shell using | &. If the -s flag is present, the 
input will be saved as a command in the history file. The flag -u 
can be used to specify a one digit file descriptor unit to read from. 
The file descriptor can be opened with the exec special command. 
The default value of n is 0. If name is omitted then REPLY is used 
as the default name. The exit status is 0 unless an end-of-file is 
encountered. An end-of-file with the -p option causes cleanup for 
this process so that another can be spawned. If the first argument 
contains a ?, the remainder of this word is used as a prompt on 
standard error when the shell is interactive. The exit status is 0 
unless an end-of-file is encountered. 

tt readonly [ name[ rvalue ] ]... 

The given names are marked readonly and these names cannot be 
changed by subsequent assignment. 

t return [ n ] 

Causes a shell function to return to the invoking script with the 
return status specified by n. If n is omitted then the return status is 
that of the last command executed. If return is invoked while not 
in ?i function or a . script, then it is the same as an exit. 

set [ dtaefhkmnopstuvx ] [ ±o option ]... [ ±A name ] [ arg ... ] 
The flags for this command have meaning as follows: 

-A Array assignment. Unset the variable name and assign 
values sequentially from the list arg. If +A is used, the 
variable name is not unset first. 
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a 


-e 


-f 

-h 

-k 


-m 


-n 


-o 


All subsequent parameters that are defined are automati¬ 
cally exported. 

If a command has a non-zero exit status, execute the 
ERR trap, if set, and exit. This mode is disabled while 
reading profiles. 

Disables file name generation. 

Each command becomes a tracked alias when first 
encountered. 

All parameter assignment arguments are placed in the 
environment for a command, not just those that precede 
the command name. 

Background jobs will run in a separate process group and 
a line will print upon completion. The exit status of 
background jobs is reported in a completion message. 
On systems with job control, this flag is turned on auto¬ 
matically for interactive shells. 

Read commands and check them for syntax errors, but do 
not execute them. Ignored for interactive shells. 

The following argument can be one of the following 
option names: 


allexport 

errexit 

bgnice 

emacs 

gmacs 

ignoreeof 

keyword 

markdirs 

monitor 

noclobber 


noexec 

noglob 

nolog 

nounset 

privileged 

verbose 

trackall 

vi 


Same as -a. 

Same as -e. 

All background jobs are run at a lower prior¬ 
ity. This is the default mode. 

Puts you in an emacs style in-line editor for 
command entry. 

Puts you in a gmacs style in-line editor for 
command entry. 

The shell will not exit on end-of-file. The 
command exit must be used. 

Same as -k. 

All directory names resulting from file name 
generation have a trailing / appended. 

Same as -m. 

Prevents redirection > from truncating exist¬ 
ing files. Require > | to truncate a file when 
turned on. 

Same as -n. 

Same as -f. 

Do not save function definitions in history 
file. 

Same as -u. 

Same as -p. 

Same as -v. 

Same as -h. 

Puts you in insert mode of a vi style in-line 
editor until you hit escape character 033. 
This puts you in move mode. A return sends 
the line. 
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viraw Each character is processed as it is typed in 
vi mode. 

xtrace Same as -x. 

If no option name is supplied then the current option set¬ 
tings are printed. 

-p Disables processing of the $HOME/.profile file and uses 

the file /etc/suidjprofile instead of the ENV file. This 
mode is on whenever the effective uid (gid) is not equal 
to the real uid (gid). Turning this off causes the effective 
uid and gid to be set to the real uid and gid. 

-s Sort the positional parameters lexicographically. 

-t Exit after reading and executing one command. 

-u Treat unset parameters as an error when substituting. 

-v Print shell input lines as they are read. 

-x Print commands and their arguments as they are exe¬ 

cuted. 

Turns off -x and -v flags and stops examining arguments 
for flags. 

Do not change any of the flags; useful in setting $1 to a 
value beginning with If no arguments follow this flag 
then the positional parameters are unset. 

Using + rather than - causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current set 
of flags may be found in $-. Unless -A is specified, the remaining 
arguments are positional parameters and are assigned, in order, to 
$1 $2 .... If no arguments are given then the names and values of 
all named parameters are printed on the standard output. If the 
only argument is +, the names of all named parameters are printed. 

t shift [ n ] 

The positional parameters from $n+ 1 ... are renamed $1 ... , 
default /z is 1. The parameter n can be any arithmetic expression 
that evaluates to a non-negative number less than or equal to $#. 

t times 

Print the accumulated user and system times for the shell and for 
processes run from the shell. 

t trap [ arg ] [ sig ]... 

arg is a command to be read and executed when the shell receives 
signal(s) sig. (Note that arg is scanned once when the trap is set 
and once when the trap is taken.) Each sig can be given as a num¬ 
ber or as the name of the signal. Trap commands are executed in 
order of signal number. Any attempt to set a trap on a signal that 
was ignored on entry to the current shell is ineffective. If arg is 
omitted or is then all trap(s) sig are reset to their original values. 
If arg is the null string then this signal is ignored by file shell and 
by the commands it invokes. If sig is ERR then arg will be exe¬ 
cuted whenever a command has a non-zero exit status, sig is 
DEBUG then arg will be executed after each command. If sig is 0 
or EXIT and the trap statement is executed inside the body of a 
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function, then the command arg is executed after the function 
completes. If sig is 0 or EXIT for a trap set outside any function 
then the command arg is executed on exit from the shell. The trap 
command with no arguments prints a list of commands associated 
with each signal number. 

tt typeset [ ±HLRZfilrtux [ n ] ] [ name[ rvalue ] ]... 

Sets attributes and values for shell parameters. When invoked 
inside a function, a new instance of the parameter name is created. 
The parameter value and type are restored when the function com¬ 
pletes. The following list of attributes may be specified: 

-H This flag provides UNIX system to host-name file mapping on 
non-UNIX system machines. 

-L Left justify and remove leading blanks from value . If n is non¬ 
zero it defines the width of the field, otherwise it is determined 
by the width of the value of first assignment. When the param¬ 
eter is assigned to, it is filled on the right with blanks or trun¬ 
cated, if necessary, to fit into the field. Leading zeros are 
removed if the -Z flag is also set. The -R flag is turned off. 

-R Right justify and fill with leading blanks. If n is non-zero it 
defines the width of the field, otherwise it is determined by the 
width of the value of first assignment. The field is left filled 
with blanks or truncated from the end if the parameter is reas¬ 
signed. The L flag is turned off. 

-Z Right justify and fill with leading zeros if the first non-blank 
character is a digit and the -L flag has not been set. If n is non¬ 
zero it defines the width of the field, otherwise it is determined 
by the width of the value of first assignment. 

-f The names refer to function names rather than parameter 
names. No assignments can be made and the only other valid 
flags are -t, -u and -x. The flag -t turns on execution tracing for 
this function. The flag -u causes this function to be marked 
undefined. The FPATH variable will be searched to find the 
function definition when the function is referenced. The flag -x 
allows the function definition to remain in effect across shell 
procedures invoked by name. 

-i Parameter is an integer. This makes arithmetic faster. If n is 
non-zero it defines the output arithmetic base, otherwise the 
first assignment determines the output base. 

-1 All upper-case characters converted to lower-case. The upper¬ 
case flag, -u is turned off. 

-r The given names are marked readonly and these names cannot 
be changed by subsequent assignment. 

-t Tags the named parameters. Tags are user definable and have 
no special meaning to the shell. 

-u All lower-case characters are converted to upper-case charac¬ 
ters. The lower-case flag, -1 is turned off. 

-x The given name s are marked for automatic export to the 
environment of subsequently-executed commands. 
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Using + rather than - causes these flags to be turned off. If no 
name arguments are given but flags are specified, a list of names 
(and optionally the values ) of the parameters which have these 
flags set is printed. (Using + rather than - keeps the values from 
being printed.) If no name s and flags are given, the names and - 
attributes of all parameters are printed. 

ulimit [ -HS ] [ limit ] 

The number of 512-byte blocks on files written by child processes 
(files of any size may be read). The limit is set when limit is 
specifed. The value of limit can be a number or the value unlim¬ 
ited. The H and S flags specify whether the hard limit or the soft 
limit is set. A hard limit cannot be increased once it is set. A soft 
limit can be increased up to the value of the hard limit. If neither 
the H or S options is specified, the limit applies to both. The 
current limit is printed when limit is omitted. In this case the soft 
limit is printed unless H is specified. 

umask [ mask ] 

The user file-creation mask is set to mask (see umaskiCj). mask 
can either be an octal number or a symbolic value as described in 
chmod{ C). If a symbolic value is given, the new umask value is 
the complement of the result of applying mask to the complement 
of the previous umask value. If mask is omitted, the current value 
of the mask is printed. 

unalias name ... 

The parameters given by the list of names are removed from the 
alias list. 

unset [ -f ] name ... 

The parameters given by the list of names are unassigned, i. e., 
their values and attributes are erased. Readonly variables cannot 
be unset. If the flag, -f, is set, then the names refer to function 
names. Unsetting ERRNO, LINENO, MAILCHECK, OPTARG, 
OPTIND, RANDOM, SECONDS, TMOUT, and _ removes their spe¬ 
cial meaning even if they are subsequently assigned to. 

t wait [ job ] 

Wait for the specified job and report its termination status. If job is 
not given then all currently active child processes are waited for. 
The exit status from this command is that of the process waited for. 
See Jobs for a description of the format of job . 

whence [ -pv ] name ... 

For each name , indicate how it would be interpreted if used as a 
command name. 

The flag, -v, produces a more verbose report. 

The flag, -p, does a path search for name even if name is an alias, a 
function, or a reserved word. 


September 24,1990 


KSH-34 



KSH (C) 


KSH(C) 


Invocation. 

If the shell is invoked by exec( S), and the first character of argument 
zero ($0) is then the shell is assumed to be a login shell and com¬ 
mands are read from /etc/profile and then from either .profile in the 
current directory or $HOME/.profile, if either file exists. Next, com¬ 
mands are read from the file named by performing parameter substitu¬ 
tion on the value of the environment parameter ENV if the file exists. 
If the -s flag is not present and arg is, then a path search is performed 
on the first arg to determine the name of the script to execute. The 
script arg must have read permission and any setuid and getgid set¬ 
tings will be ignored. Commands are then read as described below; 
the following flags are interpreted by the shell when it is invoked: 

-c string If the -c flag is present then commands are read from 
string . 

-s If the -s flag is present or if no arguments remain then 

commands are read from the standard input. Shell output, 
except for the output of the Special commands listed 
above, is written to file descriptor 2. 

-i If the -i flag is present or if the shell input and output are 

attached to a terminal (as told by ioctl (S)) then this shell 
is interactive . In this case TERM is ignored (so that kill 0 
does not kill an interactive shell) and INTR is caught and 
ignored (so that wait is interruptible). In all cases, QUIT 
is ignored by the shell. 

-r If the -r flag is present the shell is a restricted shell. 

The remaining flags and arguments are described under the set com¬ 
mand above. 


rksh Only. 

rksh is used to set up login names and execution environments whose 
capabilities are more controlled than those of the standard shell. "Hie 
actions of rksh are identical to those of ksh , except that the following 
are disallowed: 

changing directory (see cd{ C)), 
setting the value of SHELL, ENV, or PATH, 
specifying path or command names containing /, 
redirecting output (>, >|, <> , and »). 

The restrictions above are enforced after .profile and the ENV files are 
interpreted. 

When a command to be executed is found to be a shell procedure, rksh 
invokes ksh to execute it. Thus, it is possible to provide to the end- 
user shell procedures that have access to the full power of the standard 
shell, while imposing a limited menu of commands; this scheme 
assumes that the end-user does not have write and execute permissions 
in the same directory. 
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The net effect of these rules is that the writer of the .profile has com¬ 
plete control over user actions, by performing guaranteed setup 
actions and leaving the user in an appropriate directory (probably not 
the login directory). 

The system administrator often sets up a directory of commands (i.e., 
/usr/rbin) that can be safely invoked by rksh . Some systems also pro¬ 
vide a restricted editor red. 

Diagnostics 


Errors detected by the shell, such as syntax errors, cause the shell to 
return a non-zero exit status. Otherwise, the shell returns the exit 
status of the last command executed (see also the exit command 
above). If the shell is being used non-interactively then execution of 
the shell file is abandoned. Run time errors detected by the shell are 
reported by printing the command or function name and the error con¬ 
dition. If the line number that the error occurred on is greater than 
one, then the line number is also printed in square brackets ([]) after 
the command or function name. 

Files 


/etc/passwd 

/etc/profile 

/etc/suid_profile 

$HOME/.profile 

/tmp/sh* 

/dev/null 

See Also 


cat(C), cd(C), chmod(C), cut(C), echo(C), env(C), newgrp(C), stty(C), 
test(C), umask(C), vi(C), dup(S), exec(S), fork(S), ioctl(S), lseek(S), 
paste(C), pipe(S), signal(S), umask(S), ulimit(S), wait(S), rand(S), 
a.out(F), profile(M), environ(M). 

Notes 


If a command which is a tracked alias is executed, and then a com¬ 
mand with the same name is installed in a directory in the search path 
before the directory where the original command was found, the shell 
will continue to exec the original command. Use the -t option of the 
alias command to correct this situation. 
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Some very old shell scripts contain a A as a synonym for the pipe char¬ 
acter. |. 

Using the fc built-in command within a compound command will 
cause the whole command to disappear from the history file. 

The built-in command .file reads the whole file before any commands 
are executed. Therefore, alias and unalias commands in the file will 
not apply to any functions defined in the file. 

Traps are not processed while a job is waiting for a foreground pro¬ 
cess. Thus, a trap on SIGCLD won’t be executed until the forground 
job terminates. 
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I 

lists information about contents of directory 

Syntax 

1 [ -ACFRabcdfgilnopqrstu ] name ... 

Description 


For each directory argument, / lists the contents of the directory. For 
each name, l repeats its name and other requested information. The 
output is sorted alphabetically by default. When no argument is 
given, the current directory is listed. When several arguments are 
given, the arguments are first sorted appropriately, but file arguments 
appear before directories and their contents. Information is listed in 
the format of the “Is -1” command, which is identical to the / com¬ 
mand. This format and all provided switches are described in ls(C) 
and /c(C), to which should you should refer for a complete discussion 
of the capabilities of /. 

Files 


/etc/passwd Contains user IDs 

/etc/group Contains group IDs 

Notes 


Newline and tab are considered printing characters in filenames. 
The output device is assumed to be 80 columns wide. 
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last _ 

indicate last logins of users and teletypes 

Syntax 


last [ -h ] [ -n limit ] [ -t tty ] [ -w wtmpfile ] [ name ] 

Description 


last checks the wtmp file, which records all logins and logouts for 
information about a user, a serial line or any group of users and lines. 
Arguments specify a user name and/or tty. 

last -t 01 root 

would list all “root” sessions as well as all sessions on /dev/ttyOl. 
last prints the sessions of the specified users and ttys, including login 
name, the line used, the device name, the process ID, plus start time 
and elapsed time. 

last with no arguments prints a record of all logins and logouts, in 
reverse chronological order. 

The options behave as follows: 

-h no header. 

-n limit 

limits the report to n lines. 

-t line 

specifies the tty. 

-w wtmpfile 

uses wtmpfile instead of /etc/wtmp. 


Files 


/etc/wtmp login data base 

See Also 


finger(C), utmp(M), accton(ADM), acctcom(ADM), acct(F) 
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layers_ 

layer multiplexer for windowing terminals 

Syntax 

layers [-s] [-t] [-d] [-p] [-f file] [layersys-prgm] 

Description 

The layers command manages asynchronous windows [see layers^ M)] 

on a windowing terminal. Upon invocation, layers finds an unused 

jtf(HW) channel group and associates it with the terminal line on its 

standard output. It then waits for commands from the terminal. 

Command-line options: 

-s Reports protocol statistics on standard error at the end of the 

session after you exit from layers. The statistics may be 
printed during a session by invoking the program xts(ADM). 

-t Huns on xt( HW) driver packet tracing, and produces a trace 

dump on standard error at the end of the session after you 
exit from layers. The trace dump may be printed during a 
session by invoking the program xtt(ADM). 

-d If a firmware patch has been downloaded, prints out the 

sizes of the text, data, and bss portions of the firmware patch 
on standard error. 

-p If a firmware patch has been downloaded, prints the down¬ 

loading protocol statistics and a trace on standard error. 

-f file Starts layers with an initial configuration specified by file. 

Each line of the file represents a layer to be created, and has 
the following format: 

origin_x origin_y comer_x comer_y command_list 

The coordinates specify the size and position of the layer on 
the screen in the terminal’s coordinate system. If all four are 
0, the user must define the layer interactively. 
commandjist , a list of one or more commands, must be pro¬ 
vided. It is executed in the new layer using the user’s shell 
(by executing: $SHELL -i -c "commandjist"). This means 
that the last command should invoke a shell, such as /bin/sh. 
(If the last command is not a shell, then, when the last com¬ 
mand has completed, the layer will not be functional.) 
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layersys-prgm 

A file containing a firmware patch that the layers command 
downloads to the terminal before layers are created and 
commandjist is executed. 

Each layer is in most ways functionally identical to a separate termi¬ 
nal. Characters typed on the keyboard are sent to the standard input of 
the UNIX system process attached to the current layer (called the host 
process), and characters written on the standard output by the host pro¬ 
cess appear in that layer. When a layer is created, a separate shell is 
established and bound to the layer. If the environment variable 
SHELL is set, the user will get that shell, otherwise, /bin/sh will be 
used. In order to enable communications with other users via 
write(C), layers invokes the command relogin(ADM) when the first 
layer is created. relogin( ADM) will reassign that layer as the user’s 
logged-in terminal. An alternative layer can be designated by using 
relogin( ADM) directly, layers will restore the original assignment on 
termination. 

Layers are created, deleted, reshaped, and otherwise manipulated in a 
terminal-dependent manner. For instance, the AT&T TELE¬ 
TYPE 5620 DMD terminal provides a mouse-activated pop-up menu 
of layer operations. The method of ending a layers session is also 
defined by the terminal. 

Example 


layers -f startup 

where startup contains 

8 8 700 200 date ; pwd ; exec $SHELL 
8 300 780 850 exec $SHELL 


Notes 


The .rt(HW) driver supports an alternate data transmission scheme 
known as ENCODING MODE. This mode makes layers operation pos¬ 
sible even over data links which intercept control characters or do not 
transmit 8-bit characters. ENCODING MODE is selected either by set¬ 
ting a configuration option on your windowing terminal or by setting 
the environment variable DMDLOAD to the value hex before running 
layers: 

export DMDLOAD; DMDLOAD=hex 

If, after executing layers -f file, the terminal does not respond in one 
or more of the layers, often the last command in the command-list for 
that layer did not invoke a shell. 
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When invoking layers with the -s, -t, -d, or -p options, it is best to 
redirect standard error to another file to save the statistics and tracing 
output (e.g., layers -s 2>stats); otherwise all or some of the output 
may be lost. 

Files 


/dev/xt??[0-7] 

/usr/lib/layersys/lsys.8;7;3 

/usr/lib/layersys/lsys.8;?;? 

See Also 

relogin(ADM), sh(C), write(C), wtinit(ADM), xts(ADM), xtt(ADM), 
xt(HW), libwindows(S), layers(M) 
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Ic_ 

lists directory contents in columns 

Syntax 

Ic [ -lACFRabcdfgilmnopqrstux ] name... 

Description 


Ic lists the contents of files and directories, in columns. If name is a 
directory name, Ic lists the contents of the directory; if name is a 
filename, Ic repeats the filename and any other information requested. 
Output is given in columns and sorted alphabetically. If no argument 
is given, the current directory is listed. If several arguments are given, 
they are sorted alphabetically, but file arguments appear before direc¬ 
tories. 

Files that are not the contents of a directory being interpreted are 
always sorted across the page rather than down the page in columns. 
A stream output format is available in which files are listed across the 
page, separated by commas. The -m option enables this format. 

The options are: 

-1 Forces an output format with one entry per line. 

-A If not the root directory, this option displays all files that begin 
with (except and themselves). Otherwise, files are 
displayed normally. 

-C Forces columnar output, even if redirected to a file. 

-F Causes directories to be marked with a trailing and executable 
files to be marked with a trailing 

-R Recursively lists subdirectories. 

-a Lists all entries; and are not suppressed. 

-b Forces printing of nongraphic characters in the \ddd notation, in 
octal. 

-c Sorts by time of file creation, for use with -t option. 

-d If the argument is a directory, lists only its name, not its contents 
(mostly used with -1 to get status on directory). 
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-f Forces each argument to be interpreted as a directory and lists the 
name found in each slot. This option turns off -I, -t, -s, and -r, and 
turns on -a. The order is the order in which entries appear in the 
directory. 

-g The same as -1, except that the owner is not printed. 

-i Prints inode number in first column of the report for each file 
listed. 

-1 Lists in long format, giving mode, number of links, owner, group, 
size in bytes, and time of last modification for each file. If file file 
is a special file, the size field contains the major and minor device 
numbers instead. 


-m 

Forces stream output format. 

-n Same as the -1 switch, but the owner’s user ID appears instead of 
the owner’s name. If used in conjunction with the -g switch, the 
owner’s group ID appears instead of the group name. 

-o The same as -1, except that the group is not printed. 

-p Pad output with spaces. 

-q Forces printing of nongraphic characters in filenames as the char¬ 
acter “?”. 

-r Reverses the order of sort to get reverse alphabetic or oldest first as 
appropriate. 

-s Gives size in 512-byte blocks, including indirect blocks for each 
entry. 

-t Sorts by time modified (latest first) instead of by name, as is nor¬ 
mal. 

-u Uses time of last access instead of last modification for sorting (-t) 
or printing (- 1 ). 

-x Forces columnar printing to be sorted across rather than down the 
page. 

The following are alternate invocations of the lc command: 

If Produces the same output as lc -F. 

lr Produces the same output as lc -R. 
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lx Produces the same output as 1c -x. 

The mode printed under the -1 option contains 11 characters. The first 
character is: 

- If the entry is a plain file 

d If the entry is a directory 

b If the entry is a block-type special file 

c If the entry is a character-type special file 

p If the entry is a named pipe 

s If the entry is a semaphore 

m If the entry is shared data (memory) 

The next 9 characters are interpreted as 3 sets of 3 bits each. The first 
set refers to owner permissions; the next to permissions of others in 
the same user-group; and the last to all others. Within each set, the 3 
characters indicate permission to read, to write, or to execute the file 
as a program, respectively. For a directory, “execute” permission is 
interpreted to mean permission to search the directory for a specified 
file. The permissions are indicated as follows: 

r If the file is readable 

w If the file is writable 

x If the file is executable 

- If the indicated permission is not granted 

The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise the user-execute permission character is 
given as s if the file has set-user-DD mode. 

The last character of the mode (normally “x” or “-”) is t if the 1000 
bit of the mode is on. See chmod{Q) for the meaning of this mode. 

When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks, is displayed. 
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Files 


/etc/passwd 

To get user IDs for “lc -o” 

/etc/group 

To get group IDs for “lc -g” 

Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 

Notes 



Newline and tab are considered printing characters in filenames. The 
output device is assumed to be 80 columns wide. Column width 
choices are poor for terminals that can tab. 

This utility reports sizes in 512 byte blocks. lc -s will report 2 blocks 
used, rather than 1 block, since the file uses one system block of 1024 
bytes. 
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line _ 

reads one line 

Syntax 


line 

Description 


line copies one line (up to a newline) from the standard input and 
writes it on the standard output. It returns an exit code of 1 on end- 
of-file and always prints at least a newline. It is often used within 
shell files to read from the user’s terminal. 

See Also 


gets(CP), sh(C) 

Standards Conformance 


line is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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In _ 

makes a link to a file 

Syntax 

In [ -f ] filel [ file2 ...] target 

Description 

A link is a directory entry referring to a file. The same file (together 
with its size, all its protection information, etc) may have several links 
to it. There is no way to distinguish a link to a file from its original 
directory entry. Any changes to the file are effective independent of 
the name by which the file is known. 

If target is a directory, then one or more files are linked to that direc¬ 
tory. 

If In determines that the mode of target forbids writing, it will print 
the mode [see chmod(C)], ask for a response, and read the standard 
input for one line. If the line begins with y, the In occurs, if permissi¬ 
ble; if not, the command exits. 

When the -f option is used or if the standard input is not a terminal, no 
questions are asked and the In is done. 

See Also 


cp(C), mv(C), rm(C) 

Standards Conformance 


In is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 


March 15,1989 


LN-1 







LOCK(C) 


LOCK(C) 


lock _ 

locks a user’s terminal 

Syntax 


lock [-v] [ -number ] 

Description 


lock requests a password from the user, requests it again for verifica- 
tion, then locks the terminal until the password is reentered. If a 
-number is specified in the lock command, the terminal is automati¬ 
cally logged out and made available to another user after that number 
of minutes has passed. 

This command uses the file / etc!default/lock. This file has two entries: 

DEFLOGOUT = number 
MAXLOGOUT = number 


DEFLOGOUT specifies the default time in minutes a terminal will 
remain locked before the user is logged out. This default value is 
overridden if the -number option is used on the command line. If 
DEFLOGOUT and -number are not specified, the MAXLOGOUT 
value is used. 

MAXLOGOUT is the maximum number of minutes a user is permit¬ 
ted to lock a terminal. If a user attempts to lock a terminal for longer 
than this time, lock will issue a warning to the user that it is using the 
system maximum time limit. If DEFLOGOUT and -number and 
MAXLOGOUT are not specified, users are not logged out. 

DEFLOGOUT and MAXLOGOUT are configured by the system 
administrator to reflect the demand for terminals at the site. 

The lock may be terminated by killing the lock process. Only the 
superuser and the user who invoked lock may do so. 

Options 


-number Sets the time limit for lock to number of minutes, instead 
of the system default. 

-v Specifies verbose operation. 
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Files 


LOCK (C) 


/etc/default/lock 

Notes 

The file /etc/default/lock is shipped with the following default values: 

DEFLOGOUT =30 
MAXLOGOUT =60 
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logname 

gets login name 

Syntax 

logname 

Description 


logname returns the user’s login name as found in letclutmp. If no 
login name is found, logname returns the user’s user ID number. 

See Also 

env(C), id(C), getlogin(S), getuid(S), login(M), logname(S) 

Standards Conformance 

logname is conformant with: 

The X/Open Portability Guide II of January 1987. 
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Ip, cancel__ 

send/cancel requests to lineprinter 

Syntax 

lp [options]/?/^ 

Ip -i id printing options 
cancel [ids] [printers ] 

Description 

The first form of the Ip shell command arranges for the named files 
and associated information (collectively called a request ) to be 
printed. If no file names are specified on the shell command line, the 
standard input is assumed. The standard input may be specified along 
with named files on the shell command line using the file name. The 
files will be printed in the order they appear on the shell command 
line. 

The second form of Ip is used to change the options for a request. The 
print request identified by the request-id is changed according to the 
printing options specified with this shell command. The printing 
options available are the same as those with the first form of the Ip 
shell command. If request-id has finished printing, the change is 
rejected. If the request-id is already printing, it will be stopped and 
restarted from the beginning, unless the -P option has been given. 

lp associates a unique id with each request and prints it on the stan¬ 
dard output. This id can be used later to cancel, change, or find the 
status of the request. (See the section on cancel for details about can¬ 
celing a request, the previous paragraph for an explanation of how to 
change a request, and IpstatiC) for information about checking the 
status of a print request.) 

Sending a Print Request 

The first form of the Ip command is used to send a print request to a 
particular printer or group of printers. 

Options to Ip must always precede file names but may be listed in any 
order. The following options are available for lp: 

-c When Ip is invoked, copies of the files to be printed are 

made immediately. Normally, files will not be copied. If 
the -c option is not given, then the user should be careful not 
to remove any of the files before the request has been printed 


March 15,1989 


LP-1 







LP (C) 

in its entirety. It should also be noted that in the absence of 
the -c option, any changes made to the named files after the 
request is made but before it is printed will be reflected in 
the printed output. 

Prints this request using dest as the printer or class of 
printers. Under certain conditions (lack of printer availabil¬ 
ity, capabilities of printers, and so on), requests for specific 
destinations may not be accepted [see accept (ADM) and 
lpstat(C)]. By default, dest is taken from the environment 
variable LPDEST (if it is set). Otherwise, a default destina¬ 
tion (if one exists) for the computer system is used. Destina¬ 
tion names vary between systems [see lpstat( C)]. 

-f form-name [-d any] 

Prints the request on the form form-name. The LP print ser¬ 
vice ensures that the form is mounted on the printer. If 
form-name is requested with a printer destination that can¬ 
not support the form, the request is rejected. If form-name 
has not been defined for the system or if the user is not 
allowed to use the form, the request is rejected [see 
lpforms{ ADM)]. When the -d any option is given, the 
request is printed on any printer that has the requested form 
mounted and can handle all other needs of the print request. 

-H special-handling 

Prints the request according to the value of special-handling. 
Acceptable values for special-handling are hold, resume, 
and immediate, as defined below: 

hold Won’t print the request until notified. If already 
printing, stops it. Other print requests will go 
ahead of a held request until it is resumed. 

resume Resumes a held request. If it had been printing 
when held, it will be the next request printed, 
unless subsequently bumped by an immediate 
request. 

immediate 

(Available only to LP administrators) 

Prints the request next. If more than one request is 
assigned immediate, the requests are printed in 
the reverse order queued. If a request is currently 
printing on the desired printer, you have to put it 
on hold to allow the immediate request to print. 

-m Sends mail [see mail(C )] after the files have been printed. 

By default, no mail is sent upon normal completion of the 
print request. 


LP(C) 


■d dest 
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-n number 

Prints number copies of the output (default is 1). 

-o option Specifies printer-dependent or class-dependent options. 

Several such options may be collected by specifying the -o 

keyletter more than once. The standard interface recognizes 

the following options: 

nobanner 

Does not print a banner page with this request. (The 
administrator can disallow this option at any time.) 

nofilebreak 

Does not insert a form feed between the files given if 
submitting a job to print more than one file. 

\ength=scaled-decimal-number 

Prints the output of this request with pages scaled- 
decimal-number lines long. A scaled-decimal- 
number is an optionally scaled decimal number that 
gives a size in lines, columns, inches, or centimeters, 
as appropriate. The scale is indicated by appending 
the letter “i” (for inches) or the letter “c” (for cen¬ 
timeters). For length or width settings, an unsealed 
number indicates lines or columns; for line pitch or 
character pitch settings, an unsealed number indi¬ 
cates lines per inch or characters per inch (the same 
as a number scaled with “i”). For example, 
length=66 indicates a page length of 66 lines, 
length=lli indicates a page length of 11 inches, and 
length=27.94c indicates a page length of 27.94 cen¬ 
timeters. 

This option cannot be used with the -f option. 

width =scaled-decimal-number 

Prints the output of this request with page-width set 
to scaled-decimal-number columns wide. (See the 
explanation above for scaled-decimal-numbers.) 
This option cannot be used with the -f option. 

\pi=scaled-decimal-number 

Prints this request for “lines per inch” with the line 
pitch set to scaled-decimal-number lines per inch. 
This option cannot be used with the -f option. 

cpi=scaled-decimal-number 

Prints this request for “characters per inch” with the 
character pitch set to scaled-decimal-number charac¬ 
ters per inch. Character pitch can also be set to pica 
(representing 10 columns per inch) or elite 
(representing 12 columns per inch), or it can be 
compressed, which is as many columns as a printer 
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can handle. There is no standard number of columns 
per inch for all printers; see the terminfo( F) database 
for the default character pitch for your printer. The 
cpi option cannot be used in conjunction with the -f 
option. 

stty -stty-option-list 

Set the printer with a list of options valid for the stty 
command. Enclose the list with quotes if it contains 
blanks. 


-P page-list 

Prints the page(s) specified in page-list. This option can be 
used only if there is a filter available to handle it; otherwise, 
the print request will be rejected. 

The page-list may consist of range(s) of numbers, single 
page numbers, or a combination of both. The pages will be 
printed in ascending order. 

-q priority-level 

Assigns this request priority-level in the printing queue. 
The values of priority-level range from 0, the highest prior¬ 
ity, to 39, the lowest priority. If a priority is not specified, 
the default for the print service is used, as assigned by the 
system administrator. 

-s Suppresses messages from lp(C) such as “request id is .. 

-S character-set [-d any] 

-S print-wheel [-d any] 

Prints this request using the specified character-set or print- 
wheel. If a form has been specified that requires a 
character-set or print-wheel other than the one specified 
with the -S option, the request is rejected. 

For printers that take print wheels: if the print-wheel 
specified is not one listed by the administrator as acceptable 
for the printer involved in this request, the request is 
rejected unless the print wheel is already mounted on the 
printer. For printers that use selectable or programmable 
character sets: if the character-set specified is not one 
defined in the terminfo database for the printer [see 
terminfo(F)] or is not an alias defined by the administrator, 
the request is rejected. 

When the -d any option is used, the request is printed on any 
printer that has the print wheel mounted or any printer that 
can select the character set and can handle all other needs of 
the request. 
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-t title Prints title on the banner page of the output. The default is 
no title. 

-T content-type [-r] 

While the printer type information tells the print service 
what type of printer is being added, the content type infor¬ 
mation tells die print service what types of files can be 
printed. Prints the request on a printer that can support the 
specified content-type. If no printer accepts this type 
directly, a filter will be used to convert the content into an 
acceptable type. If the -r option is specified, a filter will not 
be used. If -r is specified but no printer accepts the 
content-type directly, the request is rejected. If the content- 
type is not acceptable to any printer, either directly or with a 
filter, the request is rejected. 

-w Writes a message on the user’s terminal after the files have 
been printed. If the user is not logged in, then mail will be 
sent instead. 

-y mode-list 

Prints this request according to the printing modes listed in 
mode-list. The allowed values for mode-list are locally 
defined. This option can be used only if there is a filter 
available to handle it; if there is no filter, the print request 
will be rejected. 

Canceling a Print Request 


The cancel command cancels printer requests that were made by the 
lp(C) shell command. The shell command line arguments may be 
either request-ids [as returned by lp(C)] or printer names [for a com¬ 
plete list, use lpstat{ C)]. Specifying a request-id cancels the associ¬ 
ated request even if it is currently printing. Specifying a printer can¬ 
cels the request that is currently printing on that printer. In either 
case, the cancellation of a request that is currently printing frees the 
printer to print its next available request. 

Special Options 


-R Removes file after sending it. 

-L Local printing option. Sends print job to printer 
attached to the terminal. 

The file /etc/default/lpd contains the setting of the variable 
BANNERS, whose value is the number of pages printed as a banner 
identifying each printout. This is normally set to either 1 or 2. 
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The variables LPR and PRINTER can each be set to ‘spooler’ or ‘local’. 
These variables let you send files to the spool printer or the terminal’s 
local printer, respectively. The file /usr/bin/spool contains the 
‘spooler’ setting for both variables. The file /usr/bin/local contains 
the ‘local’ setting. The following are a few examples of variable 
usage: 

lp -option spooler 

LPR=local 

LPR=spooler 

spool Ip -option device file 

Notes 


Printers for which requests are not being accepted will not be con- 
sidered when the destination is any • (Use the lpstat —a command to 
see which printers are accepting requests.) On the other hand, if a 
request is destined for a class of printers and the class itself is accept¬ 
ing requests, all printers in the class will be considered, regardless of 
their acceptance status, as long as the printer class is accepting 
requests. 

Warning 


For printers that take mountable print wheels or font cartridges, if you 
do not specify a particular print wheel or font with the -S option, 
whichever happens to be mounted at the time your request prints will 
be used. Use the lpstat -p -1 command to see what print wheels are 
available. For printers that have selectable character sets, you will get 
the standard set if you don’t give the -S option. 

Files 


/usr/spool/lp/* 

/etc/default/lpd 

See Also 


enable(C), lpstat(C), mail(C), accept(ADM), lpadmin(ADM), 
lpfilter(ADM), lpforms(ADM), lpsched(ADM), lpusers(ADM), 
terminfo(F) 


Standards Conformance 


cancel and Ip are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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Iprint__ 

print to a printer attached to the user’s terminal 

Syntax 

Iprint [ - ] [ file ] 

Description 

lprint(C ) accepts a filename to print or - to read from the keyboard. If 
die terminal has local printing abilities, it will then print the file to a 
printer attached to the printer port of the terminal. 

This command uses the file /etc/termcap. 

Options 


Tells Iprint to use the standard input for printing. 

The variables LPR and PRINTER can each be set to ‘spooler’ or ‘local’. 
These variables let you send files to the spool printer or the terminal’s 
local printer, respectively. The file /usr/bin/spool contains the 
‘spooler’ setting for both variables. The file /usr/bin/spool contains 
the ‘local’ setting. The following are a few examples of variable 
usage: 

lp -option spooler 

LPR=local 

LPR=spooler 

spool lp -option device file 


Files 


/etc/termcap 

/usr/bin/spool 

/usr/bin/local 
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Notes 


LPRINT(C) 


Only certain terminals have entries in /etc/termcap with this capabil¬ 
ity already defined (for example, Tandy’s DT-100 and DT-1, and 
Hewlett-Packard’s HP-92). 

To add attached printer capability to the termcap file for a different 
terminal, add entries for PN (start printing) and PS (end printing) with 
the appropriate control or escape characters for your terminal. 

Terminal communications parameters (such as baud rate and parity) 
must be set up on the terminal by the user. 

See Also 


“Using Printers” in the System Administrator’s Guide 

Value Added 


Iprint is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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Ipstat _ 

print information about status of LP print service 

Syntax 

Ipstat [options] 

Description 


Ipstat prints information about the current status of the LP print ser¬ 
vice. 

If no options are given, then Ipstat prints the status of all requests 
made to lp(C) by the users. Any arguments that are not options are 
assumed to be request-ids (as returned by Ip ), printers, or printer 
classes. Ipstat prints the status of such requests, printers, or printer 
classes. Options may appear in any order and may be repeated and 
intermixed with other arguments. Some of the keyletters below may 
be followed by an optional list that can be in one of two forms: a list 
of items separated from one another by a comma, or a list of items 
enclosed in double quotes and separated from one another by a comma 
and/or one or more spaces. For example: 

-u "userl, user2, user3" 

Specifying "all" after any keyletters that take "list" as an argument 
causes all information relevant to the keyletter to be printed. For 
example, the command 

Ipstat -o all 

prints the status of all output requests. 

-a [list] Print acceptance status (with respect to Ip) of destinations 
for requests [see accept ADM)], list is a list of intermixed 
printer names and class names; the default is all. 

-c [list] Print class names and their members, list is a list of class 
names; the default is all. 

-d Print the system default destination for Ip . 

-f [list] [-1] 

Print a verification that the forms in form-list are recog¬ 
nized by the LP print service. The -1 option will list the 
form descriptions. 
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IS_ 

gives information about contents of directories 

Syntax 


Is [ -ACFRabcdfgilmnopqrstux ] [ names ] 

Description 


For each directory named, Is lists the contents of that directory; for 
each file named. Is repeats its name and any other information 
requested. By default, the output is sorted alphabetically. When no 
argument is given, the current directory is listed. When several argu¬ 
ments are given, the arguments are first sorted appropriately, file argu¬ 
ments are processed before directories and their contents. 

There are three major listing formats. The default format is to list one 
entry per line, the -C and -x options enable multi-column formats, and 
the -m option enables stream output format in which files are listed 
across the page, separated by commas. In order to determine output 
format for the -C, -x, and -m options, Is uses an environment variable, 
COLUMNS, to determine the number of character positions available 
on one output line. If this variable is not set, the termcap database is 
used to determine the number of columns, based on the environment 
variable TERM. If this information cannot be obtained, 80 columns 
are assumed. 

There are many options: 

-A List all entries. Entries whose name begin with a period (.) are 
listed. Does not list current directory (.) and directory above 


-a Lists all entries. Entries whose name begin with a period (.) are 
listed. 

-R Recursively lists subdirectories encountered. 

-d If an argument is a directory, lists only its name (not its con¬ 
tents); often used with -1 to get the status of a directory. 

-C Multi-column output with entries sorted down the columns. 

-x Multi-column output with entries sorted across rather than down 
the page. 
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-m Stream output format. 

-1 Lists in long format, giving mode, number of links, owner, 
group, size in bytes, and time of last modification for each file 
(see below). If the file is a special file, the size field will contain 
the major and minor device numbers, rather than a size. 

-n The same as -1, except that the owner’s UID and group’s GID 
numbers are printed, rather than the associated character strings. 

-o The same as -1, except that the group is not printed. 

-g The same as -1, except that the owner is not printed. 

-r Reverses the order of sort to get reverse alphabetic or oldest 

first, as appropriate. 

-t Sorts by time modified (latest first) instead of by name. 

-u Uses time of last access instead of last modification for sorting 
use with the -t option. 

-c Uses time of last modification of the inode (file created, mode 
changed, etc.) for sorting use with -t option. 

-p Puts a slash (/) after each filename if that file is a directory. 

-F Puts a slash (/) after each filename if that file is a directory and 

puts an asterisk (*) after each filename if that file is executable. 

-b Forces printing of non-graphic characters to be in the octal Nddd 
notation. 

-q Forces printing of non-graphic characters in file names as the 
character (?). 

-i For each file, prints the inode number in the first column of the 
report. 

-s Gives size in blocks, including indirect blocks, for each entry. 

-f Forces each argument to be interpreted as a directory and lists 
the name found in each slot. This option turns off -1, -t, -s, and - 
r, and turns on -a. The order is the order in which entries appear 
in the directory. 
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-o [list] [-1] 

Print the status of output requests, list is a list of intermixed 
printer names, class names, and request-ids', the default is 
all. The -1 option gives a more detailed status of the 
request. 

-p [list] [-D] [-1] 

Print the status of printers named in list . If the -D option is 
given, a J>rief description is printed for each printer in list. 
If the -1 option is given, a full description of each printer’s 
configuration is given, including the form mounted, the 
acceptable content and printer types, a printer description, 
the interface used, and so on. 

-r Print the status of the LP request scheduler. 

-s Print a status summary, including the system default desti¬ 

nation, a list of class names and their members, a list of 
printers and their associated devices, a list of all forms 
currently mounted, and a list of all recognized character 
sets and print wheels. 

-S [list] [- 1 ] 

Print a verification that the character sets or the print 
wheels specified in list are recognized by the LP print ser¬ 
vice. Items in list can be character sets or print wheels; the 
default for the list is all. If the -1 option is given, each line 
is appended by a list of printers that can handle the print 
wheel or character set. The list also shows whether the 
print wheel or character set is mounted or specifies the 
built-in character set into which it maps. 

-t Print all status information. 

-u [list] Print status of output requests for users. List is a list of 
login names. The default is all. 

-v [list] Print the names of printers and the path names of the dev¬ 
ices associated with them, list is a list of printer names. 
The default is all. 

Files 


/usr/spool/lp/* 

See Also 


enable(C), lp(C) 
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Standards Conformance 


Ipstat is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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The mode printed under the -I option consists of 11 characters. The 
first character is: 

If the entry is an ordinary file. 

d If the entry is a directory. 

b If the entry is a block special file. 

c If the entry is a character special file. 

p If the entry is a named pipe. 

s If the entry is a semaphore. 

m If the entry is a shared data (memory) file. 

The next 9 characters are interpreted as 3 sets of 3 bits each. The first 
set refers to the owner’s permissions; the next to permissions of others 
in the user-group of the file; and the last to all others. Within each set, 
the 3 characters indicate permission to read, to write, and to execute 
the file as a program, respectively. For a directory, “execute” permis¬ 
sion is interpreted to mean permission to search the directory for a 
specified file. 

The permissions are indicated as follows: 

r If the file is readable. 

w If the file is writable. 

x If the file is executable. 

If the indicated permission is not granted. 

The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise, the user-execute permission character is 
given as s if the file has set-user-ID mode. The last character of the 
mode (normally x or -) is t if the 1000 (octal) bit of the mode is on. 
See chmodiC) for the meaning of this mode. The indications for set- 
ID and the 1000 bit of the mode are capitalized if the corresponding 
execute permission is not set. 

When the sizes of the files in a directory are listed, a total count of 
blocks including indirect blocks is printed. 
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/etc/passwd Gets user IDs for Is -1 and Is -o 

/etc/group Gets group IDs for Is -1 and Is -g 

/etc/termcap Gets terminal information 

See Also 

chmod(C), coltbl(M), find(C), 1(C), lc(C), locale(M), termcap(F) 

Notes 

Sorts according to the collating sequenced defined by the locale. 

Newline and tab are considered printing characters in filenames. 

Unprintable characters in filenames may confuse the columnar output 
options. 

This utility reports sizes in 512 byte blocks. Is -s interprets 1 block 
from a 1024 byte block system as 2 of its own 512 byte blocks. Thus a 
500 byte file is interpreted as 2 blocks rather than 1. 

Standards Conformance 

Is is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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machid: i386 __ 

get processor type truth value 

Syntax 

i386 

Description 

If the machine is a 386, the i '386 command will return a true value 
(exit code of 0), otherwise it will return a false (non-zero) value 
, Se ,JSf of commands are often used within makefiles [see 
make (CP)] and shell procedures [see sh (C)] to increase portability. 

See Also 

sh(C), test(C), true(C), make(CP) 
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mail __ 

interactive message processing system 

Syntax 


mail [ options ] [name...] 

Description 

mail provides a comfortable, flexible environment for sending and 
receiving messages electronically. For reading mail, mail provides 
commands to facilitate saving, deleting, and responding to messages. 
For sending mail, mail allows editing, reviewing, and other modifica¬ 
tion of the message as it is entered. 

Many of the remote features of mail will only work if the UUCP pack¬ 
age is installed on your system. 

Incoming mail is stored in a standard file for each user, called the 
mailbox for that user. When mail is called to read messages, the 
mailbox is the default place to find them. As messages are read, they 
are marked to be moved to a secondary file for storage, unless specific 
action is taken, so that the messages need not be seen again. This 
secondary file is called the mbox and is normally located in the user s 
HOME directory (see MBOX under Environment Variables). Mes¬ 
sages can be saved in other secondary files named by the user. Mes¬ 
sages remain in a secondary file until forcibly removed. 

The user can access a secondary file by using the -f option of the mail 
command. Messages in the secondary file can then be read or other¬ 
wise processed using the same commands as in the primary mailbox. 
This gives rise to the notion of a current mailbox. 

On the command line, options start with a dash (-) and any other argu¬ 
ments are taken to be destinations (recipients). If no recipients are 
specified, mail attempts to read messages from the mailbox. 
Command-line options are: 

-e Test for presence of mail, mail prints nothing and 

exits with a successful return code if there is mail 
to read. 

-f [filename ] Read messages from filename instead of mailbox. 

If no filename is specified, the mbox is used. 

-F Record the message in a file named after the first 

recipient. Overrides the record variable, if set 
(see Environment Variables). 
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-h number 


-H 

-i 


-n 


-N 

-r address 


-s subject 
-u user 

-U 


The number of network “hops” made so far. 
This is provided for network software to avoid 
infinite delivery loops. (See addsopt under 
Environment Variables). 

Print header summary only. 

Ignore interrupts. (See ignore under Environ¬ 
ment Variables). 

Do not initialize from the system default mailrc 
file. 

Do not print initial header summary. 

Pass address to network delivery software. All 
tilde commands are disabled. (See addsopt under 
Environment Variables). 

Set the Subject header field to subject. 

Read user's mailbox. This is only effective if 
user's mailbox is not read protected. 

Convert uucp style addresses to internet stan¬ 
dards. Overrides the conv environment variable. 
(See addsopt under Environment Variables). 


When reading mail, mail is in command mode. A header summary of 
die first several messages is displayed, followed by a prompt indicat¬ 
ing mail can accept regular commands (see Commands below). When 
sending mail, mail is in input mode. If no subject is specified on the 
command line, a prompt for the subject is printed. (A subject longer 
than 1024 characters will cause mail to dump core.) As the message is 
typed, mail will read the message and store it in a temporary file. 
Commands may be entered by beginning a line with the tilde (~) 
escape character followed by a single command letter and optional 
arguments. See Tilde Escapes for a summary of these commands. 


At any time, the behavior of mail is governed by a set of environment 
variables. These are flags and valued parameters which are set and 
cleared via the set and unset commands. See Environment Variables 
below for a summary of these parameters. 


Recipients listed on the command line may be of three types: login 
names, shell commands, or alias groups. Login names may be any 
network address, including mixed network addressing. If mail is 
found to be undeliverable, an attempt is made to return it to the 
sender’s mailbox. If the recipient name begins with a pipe symbol (I), 
the rest of the name is taken to be a shell command to pipe the mes¬ 
sage through. This provides an automatic interface with any program 
that reads the standard input, such as lp( C), for recording outgoing 
mail on paper. Alias groups are set by the alias command (see Com¬ 
mands below) and are lists of recipients of any type. 
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Regular commands are of the form: 

[ command ] [ msglist ] [ arguments ] 

If no command is specified in command mode , print is assumed. In 
input mode, commands are recognized by the tilde escape character, 
and lines not treated as commands are taken as input for the message. 

Each message is assigned a sequential number, and there is at any 
time the notion of a current message, marked by a right angle bracket 
(>) in the header summary. Many commands take an optional list of 
messages (msglist) to operate on. The default for msglist is the current 
message. A msglist is a list of message identifiers separated by 
spaces, which may include: 

n Message number n. 

. The current message. 

* The first undeleted message. 

$ The last message. 

* All messages. 

n-m An inclusive range of message numbers. 

user All messages from user. 

/string All messages with string in the subject line (case 

ignored). 

:c All messages of type c, where c is one of: 

d deleted messages 
n new messages 
o old messages 
r read messages 
u unread messages 

Note that the context of the command determines whether this type 
of message specification makes sense. 

Other arguments are usually arbitrary strings whose usage depends on 
the command involved. File names, where expected, are expanded via 
the normal shell conventions [see s/z(C)]. Special characters are 
recognized by certain commands and are documented with the com¬ 
mands below. 

At start-up time, mail tries to execute commands from the optional 
system-wide file (/usr/lib/mail/mailrc) to initialize certain parame¬ 
ters, then from a private start-up file ($HOME/.maiIrc) for personal¬ 
ized variables. With the exceptions noted below, regular commands 
are legal inside start-up files. The most common use of a start-up file 
is to set up initial display options and alias lists. The following com¬ 
mands are not legal in the start-up file: !, Copy, edit, forward. For¬ 
ward, hold, mail, preserve, reply. Reply, shell, and visual. An error 
in the start-up file causes the remaining lines in the file to be ignored. 
The .mailrc file is optional and must be constructed locally. 
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Commands 

The following is a complete list of mail commands: 

Ishell-command 

Execute shell command and return. (See SHELL under Environ¬ 
ment Variables). 

# comment 

Null command (comment). This may be useful in .mailrc files. 


Print the current message number. 


? 

Print a summary of commands. 

alias alias name ... 
group alias name ... 

Declare an alias for the given names. The names will be substi¬ 
tuted when alias is used as a recipient. Useful in the .mailrc file. 

alternates name ... 

Declare a list of alternate names for your login. When responding 
to a message, these names are removed from the list of recipients 
for the response. With no arguments, alternates prints the current 
list of alternate names. (See allnet under Environment Variables). 

cd [< directory] 
chdir [directory] 

Change directory. If directory is not specified, $HOME is used. 

copy [filename] 
copy [msglist] filename 

Copy messages to the file without marking the messages as saved. 
Otherwise equivalent to the save command. 

Copy [msglist] 

Save die specified messages in a file whose name is derived from 
the author of the message to be saved, without marking the mes¬ 
sages as saved. Otherwise equivalent to the Save command. 

delete [msglist] 

Delete messages from the mailbox. If autoprint is set, the next 
message after the last one deleted is printed (see Environment 
Variables). 

discard [header-field ...] 
ignore [header-field ...] 

Suppress printing of the specified header fields when displaying 
messages on the screen. Examples of header fields to ignore are 
“status” and “cc”. The fields are included when the message is 
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saved. The Print and Type commands override these commands. 

dp [msglist] 
dt [msglist] 

Delete the specified messages from the mailbox and print the next 
message after the last one deleted. Roughly equivalent to a delete 
command followed by a print command. 

echo string ... 

Echo the given strings [like echo(C )]. 
edit [msglist] 

Edit the given messages. The messages are placed in a temporary 
file and the EDITOR variable is used to get the name of the editor 
(see Environment Variables). Default editor is ed( C). 

exit 

xit 

Exit from mail without changing the mailbox. No messages are 
saved in the mbox (see also quit). 

file [filename] 
folder [filename] 

Quit from the current file of messages and read in the specified file. 
Several special characters are recognized when used as file names, 
with the following substitutions: 

% the current mailbox. 

%user the mailbox for user. 

# the previous file. 

& the current mbox. 

Default file is the current mailbox. 

folders 

Print the names of the files in the directory set by the folder vari¬ 
able (see Environment Variables). 

forward [message] name ... 

Forward the specified message to the specified users, shifting the 
forwarded text to the right one tab stop. 

Forward [message] name ... 

Forward the specified message to the specified users, with no 
indentation. 

from [msglist] 

Prints the header summary for the specified messages. 

group alias name ... 

See alias. 
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headers [+1-1 msglist] 

Lists the current range of headers. The screen variable sets the 
number of headers per page (see Environment Variables). If a “+” 
argument is given, then the next page is printed, and if a argu¬ 
ment is given, the previous page is printed. Both “+” and can 
take a number to view a particular window. If a message list is 
given, it prints the specified headers, disregarding all windowing. 
See also the z command. 

help 

Prints a summary of commands. 

hold [msglist] 
preserve [msglist] 

Holds the specified messages in the mailbox, 
if s I r 

mail-commands 

else 

mail-commands 

endif 

Conditional execution, where s causes the first mail commands, up 
to an else or endif to be executed if the program is in send mode, 
and r causes the mail commands to be executed only in receive 
mode. The mail-commands after the else are executed if the pro¬ 
gram is in the opposite mode from the one indicated. Useful in the 
.mailrc file. 

ignore header-field ... 
discard header-field ... 

Suppresses printing of the specified header fields when displaying 
messages on the screen. Examples of header fields to ignore are 
“status” and “cc”. All fields are included when the message is 
saved. The Print and Type commands override this command. 


list 

Prints all commands available. No explanation is given, 
lpr [msglist] 

Print the specified messages on the lineprinter. 
mail name ... 

Mail a message to the specified users. 

Mail name 

Mail a message to the specified user and record a copy of it in a file 
named after that user. 

mbox [msglist] 

Arrange for the given messages to end up in the standard mbox 
save file when mail terminates normally. See the exit and quit 
commands. 
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next [< message] 

Go to next message matching message. A msglist may be 
specified, but in this case the first valid message in the list is the 
only one used. This is useful for jumping to the next message from 
a specific user, since the name would be taken as a command in the 
absence of a real command. See the discussion of msglists above 
for a description of possible message specifications. 

pipe [msglist] [shell-command] 

| [msglist] [shell-command] 

Pipe the message through the given shell-command. The message 
is treated as if it were read. If no arguments are given, the current 
message is piped through the command specified by the value of 
the cmd variable. If the page variable is set, a form feed character 
is inserted after each message (see Environment Variables). 

preserve [msglist] 

See hold. 

Print [msglist] 

Type [msglist] 

Print the specified messages on the screen, including all header 
fields. Overrides suppression of fields by the ignore command. 

print [msglist] 
type [msglist] 

Print the specified messages. If crt is set, the messages longer than 
the number of lines specified by the crt variable are paged through 
the command specified by the PAGER variable. The default com¬ 
mand is more(C) (see Environment Variables). 


quit . . , 

Exit from mail, storing messages that were read m inbox and 
unread messages in the mailbox. Messages that have been explic¬ 
itly saved in a file are deleted from the mailbox. 

Reply [msglist] 

Respond [msglist] 

Reply to the specified message, including all other recipients of the 
message. If record is set to a file name, the response is saved at 
the end of that file (see Environment Variables). 

reply [message] 

respond [message] . , 

Send a response to the author of each message m the msglist. Ihe 
subject line is taken from the first message. If record is set to a 
file name, the response is saved at the end of that file (see Environ¬ 
ment Variables). 
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Save [msglist] 

Save the specified messages in a file whose name is derived from 
the author of the first message. The name of the file is taken to be 
the author’s name with all network addressing stripped off. See 
also the Copy commands and outfolder (Environment Variables). 


save [filename] 
save [msglist] filename 

Save the specified messages in the given file. The file is created if 
it does not exist. The message is deleted from the mailbox when 
mail terminates unless keepsave is set (see also Environment Vari¬ 
ables and the exit and quit commands). 


set 

set name 

set name-string 

set name=number 

Define a variable called name. The variable may be given a null, 
string, or numeric value. Set by itself prints all defined variables 
and their values. See Environment Variables for detailed descrip¬ 
tions of the mail variables. 

shell 

Invoke an interactive shell (see SHELL under Environment Vari¬ 
ables). 

size [msglist] 

Print the size in characters of the specified messages. 
source filename 

Read commands from the given file and return to command mode, 
top [msglist] 

Print the top few lines of the specified messages. If the toplines 
variable is set, it is taken as the number of lines to print (see 
Environment Variables). The default is 5. 

touch [msglist] 

Touch the specified messages. If any message in msglist is not 
specifically saved in a file, it will be placed in the mbox, or the file 
specified in the MBOX environment variable, upon normal termi¬ 
nation. See exit and quit. 

Type [msglist] 

See Print. 
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type [msglist] 

See print. 

undelete [msglist] 

Restore die specified deleted messages. Will only restore mes¬ 
sages deleted in the current mail session. If autoprint is set, the 
last message of those restored is printed (see Environment Vari¬ 
ables). 

unset name ... 

Causes the specified variables to be erased. If the variable was 
imported from the execution environment (i.e., a shell variable), 
then it cannot be erased. 

version 

Prints the current version and release date, 
visual [msglist] 

Edit the given messages with a screen editor. The messages are 
placed in a temporary file and the VISUAL variable is used to get 
the name of the editor (see Environment Variables). 

write [msglist] filename 

Write the given messages on the specified file, minus the header 
and trailing blank line. Otherwise equivalent to the save com¬ 
mand. 


xit 

See exit. quit). 
z[+ I -] 

Scroll the header display forward or backward one full screen. The 
number of headers displayed is set by the screen variable (see 
Environment Variables). 


Tilde Escapes 

The following commands may be entered only from input mode , by 
beginning a line with the tilde escape character (~). See escape under 
Environment Variables for changing this special character. 

~l shell-command 

Execute the shell command and return. 


Simulate end of file (terminate message input). 

: command 
_ command 

Perform the command-level request. Valid only when sending a 
message while reading mail. 
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Print a summary of tilde escapes. 

A 

Insert the autograph string Sign into the message (see Environment 
Variables). 

'a 

Insert the autograph string sign into the message (see Environment 
Variables). 

~b name ... 

Add the name s to the blind carbon copy (Bcc) list, 
c name ... 

Add the name s to the carbon copy (Cc) list. 


Read in the dead.letter file. (See DEAD under Environment Vari¬ 
ables for a description of this file.) 


Invoke the editor on the partial message. (See EDITOR under 
Environment Variables.) 

f [msg list] 

Forward the specified messages. The messages are inserted into 
the message without alteration. 

~h 

Prompt for Subject line and To, Cc, Bcc, and Retum-Receipt-to 
lists. If the field is displayed with an initial value, it may be edited 
as if you had just typed it. 

‘i variable 

Insert the value of the named variable into the text of the message. 
For example, A is equivalent to ’~i Sign.’ Environment variables 
set and exported in the shell are also accessible by ~i. 

~M [msglist] 

Insert the specified messages into the letter, with no indentation. 
Valid only when sending a message while reading mail. 

~m [msg list] 

Insert the specified messages into the letter, shifting the new text 
to the right one tab stop. Valid only when sending a message while 
reading mail. 


P 

Print the message being entered. 
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Quit from input mode by simulating an interrupt. If the body of the 
message is not null, the partial message is saved in dead.letter. 
(See DEAD under Environment Variables). 

~r filename 

~~< filename 

~~< \shell-command 

Read in the specified file. If the argument begins with an exclama¬ 
tion point (!), the rest of the string is taken as an arbitrary shell 
command and is executed, with the standard output inserted into 
the message. 


s string ... 

Set the subject line to string. 


t name... 

Add the given names to the To list. 


Invoke a preferred screen editor on the partial message. (See also 
VISUAL under Environment Variables.) 


w filename 

Write the partial message onto the given file, without the header. 


Exit as with "q except the message is not saved in dead.letter. 


~\ shell-command 

Pipe the body of the message through the given shell-command. It 
the shell-command returns a successful exit status, the output of 
the command replaces the message. 


Environment Variables 

The following are environment variables taken from the execution 
environment and are not alterable within mail. 

HOME ^directory 

The user’s base of operations. 

MAILRC ^filename 

The name of the start-up file. Default is $HOME/.mailrc. 
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The following variables are internal mail variables. They may be 
imported from the execution environment or set via the set command 
at any time. The unset command may be used to erase variables. 

addsopt 

Enabled by default. If /bin/mail is not being used as the deliverer, 
noaddsopt should be specified. (See Notes below) 

allnet 

All network names whose last component (login name) match are 
treated as identical. This causes the msglist message specifications 
to behave similarly. Default is noallnet. See also the alternates 
command and the metoo variable. 

append 

Upon termination, append messages to the end of the mbox file 
instead of prepending them. Default is noappend. 

askcc 

Prompt for the Cc list after message is entered. Default is 
noaskcc. 

asksub 

Prompt for subject if it is not specified on the command line with 
the -s option. Enabled by default. 

autoprint 

Enable automatic printing of messages after delete and undelete 
commands. Default is noautoprint. 

bang 

Enable the special-casing of exclamation points (!) in shell escape 
command lines as in v/(C). Default is nobang. 

chron 

Causes messages to be displayed in chronological order. The 
default is reverse chronological order (most recent message first). 
See also mchron below. 

cmA—shell-command 

Set the default command for the pipe command. Not set bv 
default. } 

con \=conversion 

Convert uucp addresses to the specified address style. The only 
valid conversion now is internet, which requires a mail delivery 
program conforming to the RFC822 standard for electronic mail 
addressing. Conversion is disabled by default. See also the send- 
mail variable and the -U command-line option. 
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crt-number 

Pipe messages having more than number lines through the com¬ 
mand specified by the value of the PAGER variable (more{ C) by 
default). Disabled by default. 

DEAD =filename 

The name of the file in which to save partial letters in case of 
untimely interrupt. Default is $HOME/dead.letter. 

debug 

Enable verbose diagnostics for debugging. Messages are not 
delivered. Default is nodebug. 

dot 

Take a period on a line by itself during input from a terminal as 
end-of-file. Default is nodot. 

EDITOR=shell-command 

The command to run when the edit or 'e command is used. Default 
is ed(C). 

escapes 

Substitute c for the “ escape character. Takes effect with next mes¬ 
sage sent. 

fo\Aer=directory 

The directory for saving standard mail files. User-specified file 
names beginning with a plus (+) are expanded by preceding the file 
name with this directory name to obtain the real file name. If 
directory does not start with a slash (/), $HOME is prepended to it. 
In order to use the plus (+) construct on a mail command line, 
folder must be an exported sh environment variable. There is no 
default for the folder variable. See also outfolder below. 

header 

Enable printing of the header summary when entering mail. 
Enabled by default. 

hold J r 

Preserve all messages that are read in the mailbox mstead ot put¬ 
ting them in the standard mbox save file. Default is nohold. 

ignore . 

Ignore interrupts while entering messages. Handy for noisy dial¬ 
up lines. Default is noignore. 

ignoreeof 

Ignore end-of-file during message input. Input must be terminated 
by a period (.) on a line by itself or by the . command. Default is 
noignoreeof. See also the dot variable above. 
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keep 

When the mailbox is empty, truncate it to zero length instead of 
removing it. Disabled by default. 

keepsave 

Keep messages that have been saved in other files in the mailbox 
instead of deleting them. Default is nokeepsave. 

MBOX=filename 

The name of the file to save messages which have been read. The 
xit command overrides this function, as does saving the message 
explicitly in another file. Default is $HOME/mbox. 

mchron 

Causes message headers to be listed in numerical order (most 
recently received first), but displayed in chronological order. See 
also chron above. 

metoo 

If your login appears as a recipient, do not delete it from the list. 
Default is nometoo. 

LISTER =shell-command 

The command (and options) to use when listing the contents of the 
folder directory. The default is ls(C). 

onehop 

When responding to a message that was originally sent to several 
recipients, the other recipient addresses are normally forced to be 
relative to the originating author’s machine for the response. This 
flag disables alteration of the recipients’ addresses, improving 
efficiency in a network where all machines can send directly to all 
other machines (i.e., one hop away). 

outfolder 

Record outgoing messages in files located in the directory 
specified by the folder variable unless the path name is absolute. 
Default is nooutfolder. See the folder variable above and the 
Save and Copy commands. 

page 

Used with the pipe command to insert a form feed after each mes¬ 
sage sent through the pipe. Default is nopage. 

PAGER =shell-command 

Use shell-command as a filter for paginating output. This can also 
be used to specify the options to be used. Default is more(C). 

prompt =string 

Set the command mode prompt to string. Default is ? . 
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quiet 

Refrain from printing the opening message and version when 
entering mail. Default is noquiet. 

record -filename 

Record all outgoing mail in filename. Disabled by default. See 
also outfolder above. 

save 

Enable saving of messages in dead.letter on interrupt or delivery 
error. See DEAD for a description of this file. Enabled by default. 

screen ^number 

Sets the number of lines in a full screen of headers for the headers 
command. 

sendmm\=shell-command 

Alternate command for delivering messages. Default is 
/bin/rmail(C). 

sendwait 

Wait for background mailer to finish before returning. Default is 

nosendwait. 

SHELL=shell-command 

The name of a preferred command interpreter. Default is sh( C). 

showto 

When displaying the header summary and the message is from you, 
print the recipient’s name instead of the author’s name. 

sign =string 

The variable inserted into the text of a message when the “a (auto¬ 
graph) command is given. Not set by default (see i under Tilde 
Escapes). 

Sign =string 

The variable inserted into the text of a message when the "A com¬ 
mand is given. Not set by default (see also 'i under Tilde Escapes). 

top\\nes=number 

The number of lines of header to print with the top command. 
Default is 5. 

VISV AL=shell-command 

The name of a preferred screen editor. Default is vi(C). 
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$HOME/.mailrc personal start-up file 

$HOME/mbox secondary storage file 

Aisr/spool/mail post office directory 

/usr/lib/mail/mail.help* help message files 
/usr/lib/mail/mailrc optional global start-up file 

/tmp/R[emqsx]* temporary files 


See Also 

ls(C), mail(C), more(C) 

Notes 


pie -h, -r and -U options can be used only if mail is built with a 
delivery program other than /bin/mail. 

Where shell-command is shown as valid, arguments are not always 
allowed. Experimentation is recommended. 

Internal variables imported from the execution environment cannot be 
unset. 

The full internet addressing is not fully supported by mail. The new 
standards need some time to settle down. 

A line consisting only of a is treated as the end of the message. 

Standards Conformance 


mail is conformant with: 

AT&T SVTD Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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man ___ 

prints reference pages in this guide 

Syntax 

man [-afbcw] [-t proc] [-p pager] [-d dir ] [- 
T term] [ section ] [title] 

/usr/lib/manprog file 

Description 

The man program locates and prints the named title from the desig¬ 
nated reference section For historical reasons, “page” is often used as 
a synonym for “entry” in this context. 

Since UNIX commands are given in lowercase, the title is always 
entered in lowercase. If no section is specified, the whole guide is 
searched for title and the first occurrence of it is printed. You can 
search for a group of sections by separating the section names with 
, colons (:) on the command line. 

The options and their meanings are: 

“All” mode. Displays all matching titles. Incompatible 
with the -f option. 

“First” mode. Displays only the first matching title. 
Incompatible with -a option. This is the default mode for 
man(C). 

Leaves blank lines in output. nrofflCT) pads entries with 
blank lines for line printer purposes, man normally 
filters out these excess blank lines. Normally, man does 
not display more than 2 consecutive blank lines. The -b 
flag leaves blank lines in the CRT output. 

Causes man to invoke col(C). Note that col is invoked 
automatically by man unless term is one of the follow¬ 
ing: 300,300s, 450,37,4000a, 382,4014, tek, 1620, and 
X. 

Prints on the standard output only the pathnames of the 
entries. 

Indicates that if an unprocessed manual page is avail¬ 
able, it is to be passed to proc for formatting, proc can be 
any command script in lusrlmanlbin or an absolute 
filename of a text processing program elsewhere on the 
system, for example Ibinlnroff. 


-a 

-f 

-b 

-c 

-w 

-t proc 
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The scripts in lusrlmanlbin invoke the actual processing 
programs with the correct flags and arguments. The 
default processor is lusrlmanlbinlnr , which invokes 
Ibinlnroff and produces output that safely prints on any 
terminal. The text is also preprocessed by eqn(CT) and 
tbl(CT) as a default. 

■P pager Selects paging program pager to display the entry. Pag¬ 

ing systems such as more(C), pg(C), cat(C), or any cus¬ 
tom pagers that you may have are valid arguments for 
this flag. The default pager, pg(C), is set in 
I etc! default! man. 

"d dir Specifies directory dir to be added to the search path for 

entries. You can specify several directories to be 
searched by separating the directory names with colons 
(:) on the command line. 

-T term Format the entry and pass the given term value to the 

processing program, then print it on the standard output 
(usually, the terminal), where term is the terminal type 
(see term(M) and the explanation below). 

Section Names 

The names and general descriptions of the available manual sections 
are: 

ADM System Administration 

C Commands 

M Miscellaneous 

F File Formats 

HW Hardware Dependent 

S Subroutines and Libraries 

CP Programming Commands 

DOS DOS Subroutines and Libraries 

LOCAL Local utilities for your system 

You can add other section names as you desire. Each new section, 
however, must follow the standard section directory structure. The 
LOCAL directory is shipped without contents, as no LOCAL manual 
pages are included. 

/usr/man Directory Structure 


The source files for the man(C) program are kept in the directory 
lusrlman. Each man section is comprised of two directories, and there 
is a directory called bin for programs and shell scripts related to 
man(C). There is also an index file called index in lusrlman. This 
index is a list of all UMX commands and their sections. 

Each manual section has two directories in lusrlman. These directories 
are called man and cat, plus the name of the section as a suffix. For 
example, the C manual section is comprised of two directories, man.C 
and cat.C , both located in lusrlman. 
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The unprocessed source text is in the man directory and the printable 
processed output is in the cat directory. When a title is requested, both 
directories are checked. The most recent copy of the manual page is 
used as the current copy. If the most recent title is in the source text 
directory and it is processed by the default processor with the default 
terminal type, a display copy of the output is placed in the cat direc¬ 
tory for future use. Note that a file that must be processed takes longer 
to appear on the screen than a display copy. 

Environment Variables 

There is a shell environment variable for use with the man(C) utility. 
This variable is called MANPATH and it is used to change or aug¬ 
ment the path man(C) searches for entries. Multiple directories set 
with this variable must be delimited by colon characters (:). If the 
MANPATH environment variable is present, the directories are 
searched in the order that they appear, /usr/man must appear in the 
MANPATH list to be included. If you set this environment variable, 
it supersedes the MANPATH entry in the I etc! default! man file. Alter¬ 
nate subdirectories are expected to have the same form as the default 
directories in /usrlman. 

/etc/default/man 

There is a file called man in the / etc!default directory that contains the 
default settings for the man utility. The following options are set in 
I etc! default! man: 

PAGER=/usr/bin/pg 
MANPATH=/usr/man 
TERM=lp 

ORDER=ADM:C:S:CP:M:F:HW:DOS:LOCAL 

MODE=FIRST 

PROC=nr 

You can select a different paging system, search path, terminal type, 
search order, mode, and processor for the man(C) system by changing 
the information in this file. 

To change the search order for manual sections, edit the list following 
the ORDER variable. Be certain the section names are separated with 
colons (:). Section names not present in ORDER are searched in arbi¬ 
trary order after those specified in / etc!default!man. 

Creating New Manual Entries 

You can create new manual pages for utilities and scripts that you 
have developed. Use an existing manual page as an example of 
manual page structure. Use the man macros to format your manual 
page. For more information, refer to the nrofl^CT) manual page. 

You must be logged in as root (the “Super-User”) to place a new 
manual page in your /usr/man directory structure. Place your new 
page in /usr/man!man.LOCAL while logged in as root and view it 
using the man(C) command, since only root has write permission for 
the cat-able directories. Once man has produced the cat-able output. 
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any user can view the new page in the same manner as any other on 
lme manual page. 

Additionally, you can create your own custom sections by creating 
another manual directory and putting it in the MANPATH. For exam¬ 
ple, if subdirectories manX and catX are present, then man(C) recog- 
mzes that X is a valid manual section. 

If you wish to use another text processing program (such as troffTCT)) 
to process your custom manual pages, use the -t proc flag of man. proc 
can be any shell script in /usr/man/bin. To place a cat-able copy of the 
manual page m the cat directory, use the tee(C) command to send the 
output to a file, as well as to the standard output. Your command 
should have the form: 

man -t proc filename I tee pathname 
In the above example, proc is the text processing script, filename is the 
manual page source file, and pathname is the path of the directory for 
the cat-able output. J 

Custom manual sections can have an index, if the format is the same 
as the mdex in /usr/man. man(C) uses the index to locate multiple 
commands that are listed on the same page as well as commands that 
have pages in several different sections. 

The man Macro Package 

The man macro package is located in /usr/lib/macros/an. There are 
15 basic macros in the package. Here is a table of the macros and brief 
descriptions of their functions: 

Macro Description 


.TH title Title Heading 

.SH title Section Heading 

.SS title Subsection Heading 

.SM text Reduce Point Size 

•PP New Paragraph 

.IP Indented Paragraph 

.HP Hanging Paragraph 

.TP Tagged Paragraph 

.RS n Relative Indent 

.RE Release Relative Indent 

.1 text Italic Font 

.B text Bold Font 

.R text Roman Font 

.PM Proprietary Mark (copyright) 


See Also 


eqnchar(CT), nroff(CT), tbl(CT), troff(CT), environ(M), term(F) 
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Notes 


All entries are supposed to be reproducible either on a typesetter or on 
a terminal. However, on a terminal some information, such as 
eqn(CT) and tbl(CT) output, is either lost or approximated as it cannot 
be exactly reproduced. 
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mesg _ 

permits or denies messages sent to a terminal 

Syntax 


mesg [ n ] [ y ] 

Description 


mesg with argument n forbids messages via write (C) by revoking 
nonuser write permission on the user’s terminal, mesg with argument 
y reinstates permission. All by itself, mesg reports the current state 
without changing it. 

Files 


/dev/tty* 

See Also 


write(C) 

Diagnostics 


Exit status is 0 if messages are receivable, 1 if not, 2 on error. 


Standards Conformance 


mesg is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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mkdir _ 

makes a directory 

Syntax 

mkdir [ -m mode ] [ -p] dimame ... 

Description 

The mkdir command creates the named directories in mode 111 [pos¬ 
sibly altered by umask(C)]. 

Standard entries in a directory (e.g., the files for the directory itself, 
and ... for its parent) are made automatically, mkdir cannot create 
these entries by name. Creation of a directory requires write permis¬ 
sion in the parent directory. 

The owner ID and group ID of the new directories are set to the pro¬ 
cess’s real user ID and group ID, respectively. 

Two options apply to mkdir: 

-m This option allows users to specify the mode to be used for new 
directories. Choices for modes can be found in chmod( C). 

-p With this option, mkdir creates dirname by creating all the non¬ 
existing parent directories first. 

See Also 


sh(C), rm(C), rmdir(C), umask(C), mkdir(S) 

Diagnostics 

The mkdir command returns exit code 0 if all directories given in the 
command line were made successfully. Otherwise, it prints a diagnos¬ 
tic and returns non-zero. An error code is stored in errno. 

Standards Conformance 

mkdir is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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mknod 

builds special files 

Syntax 


/etc/mknod name [ c I b ] major minor 
/etc/mknod name p 
/etc/mknod name s 
/etc/mknod name m 

Description 


mknod makes a directory entry and corresponding inode for a special 
file. The first argument is the name of the entry. In the first case, the 
second argument is b if the special file is block-type (disks, tape) or c 
if it is character-type (other devices). The last two arguments are 
numbers specifying the major device type and the minor device (e.g., 
unit, drive, or line number), which may be either decimal or octal. 

The assignment of major device numbers is specific to each system. 
Major device numbers can be found in the system source file 
/etc/conf/cf.d/mdevice. 

mknod can also be used to create named pipes with the p option, 
semaphores with the s option, and shared data (memory) with the m 
option. 

Only the super-user can use the first form of the syntax. 

See Also 


mknod(S) 

Standards Conformance 


mknod is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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mnt, umnt 

mount a filesystem 


Syntax 

/usr/bin/mnt [ -urat ] [ directory ] 
/usr/bin/umnt directory 


Description 

mnt allows users other than the super-user to access the functionality 
of the mount(ADNl) command to mount selected filesystems. The 
super-user can define how and when a filesystem mount is permitted 
via special entries in the /etc/default/filesys file. 

The filesystem requirements are the same as defined for mound ADM). 

umnt removes the mountable filesystem previously mounted in direc¬ 
tory . 

mnt is invoked from the letclrc scripts with the -r and possibly the -a 
flag to mount filesystems when the system comes up multiuser. The 
-a flag is used when the system has autobooted. Neither of these flags 
should be specified during normal use. 

The -t flag displays the contents of /etc/default/filesys. 

The -u flag forces mnt to behave like umnt. 


Options 

The following options can be defined in the I etc/default/filesys entry 
for a filesystem: 


bdev=/dev/device Name of block device associated with the 

filesystem. 

cdev=/dev /device Name of character (raw) device associated 

with the filesystem. 


rao\xntd\r=/directory The directory the filesystem is to be mounted 
on. 

desc =name A string describing the filesystem. 
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passwd=.rtn/ 2 g An optional password prompted for at mount 

request time. Cannot be a simple string; must 
be in the format of /etc/passwd. (See Notes.) 

fsck=yes, no, dirty, prompt 

If yes/no, tells explicitly whether or not to run 
fsck. If dirty, fsck is run only if the filesystem 
requires cleaning. If prompt, the user is 
prompted for a choice. If no entry is given, 
the default value is dirty. 

fsckflags=/7tfgs Amy flags to be passed to fsck. 

rcfsck=yes, no, dirty, prompt 

Similar to fsck entry, but only applies when 
the -r flag is passed. 

maxcleans=A 2 The number of times to repeat cleaning of a 

duty filesystem before giving up. If 
undefined, default is 4. 

mount=yes, no, prompt 

If yes or no, users are allowed or disallowed 
to mount the filesystem, respectively. If 
prompt, the user specifies whether the filesys¬ 
tem should be mounted. 

rcmount=yes, no, prompt 

If yes, the filesystem is mounted by Ietclrc2 
when the system comes up multiuser. If no, 
the filesystem is never mounted by Ietclrc2 . 
With prompt, a query is displayed at boot 
time to mount the filesystem. 

mountflags=yZag,s Any flags to be passed to mount . 

prep=yes, no, prompt Indicates whether any prepcmd entry should 
always be executed, never executed, or exe¬ 
cuted as specified by user. 

An arbitrary shell command to be invoked 
immediately following password check and 
prior to running /sr/:. 

Indicates whether an initcmd entry should 
always be executed, never be executed, or 
executed as specified by user. 

An optional, arbitrary shell command to be 
invoked immediately following a successful 
mount. 
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init=yes, no, prompt 


initcmd ^command 


March 15,1989 



MNT (C) 


MNT(C) 


Any entries containing spaces, tabs, or newlines must be contained in 
double quotes ("). 

The only mandatory entries in I etc Idefault!filesys are bdev and 
mountdir. The prepcmd and initcmd options can be used to execute 
another command before or after mounting the filesystem. For exam¬ 
ple, initcmd could be defined to send mail to root whenever a given 
filesystem is mounted. 

When invoked without arguments, mnt attempts to mount all filesys¬ 
tems that have the entries mount=yes or mount=prompt. 

Examples 

The following is a sample Ietcldefault/filesys file: 

bdev^/dev/root cdev^/dev/rroot mountdir=/ \ 
d esc =»The Root Filesystem" rcmount=no mount=no 

bdev=/dev/u cdev^/dev/ru mountdir=/u ranount=yes \ 
fsckflags=-y desc="The User Filesystem" 

bdev^/dev/x cdev^/dev/rx mountdir=/u rcmount==no \ 
mount=yes fsckflags=-y desc="The Extra Filesystem" 

Of the examples above, only lx is mountable by the user. 

Files 


/etc/default/filesys Filesystem data 

See Also 


mount(ADM), default(F) 

Diagnostics 

mnt will fail if the filesystem to be mounted is currently mounted 
under another name. 

Busy filesystems cannot be unmounted with umnt. A filesystem is busy 
if it contains an open file or if a user’s present working directory 
resides within the filesystem. 
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Some degree of validation is done on the filesystem, however it is gen- 
erally unwise to mount corrupt filesystems. 

In order to create a password for a filesystem, the system administrator 
must run the passwd{C) command using the -f option. 

Value Added 


mnt is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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more _ 

views a file one screen full at a time 


Syntax 

more [ -cdflrsuvw ][-«][ +linenumber ] [ +/pattem ] [ name ... ] 

Description 

This filter allows examination of a continuous text one screen full at a 

time. It normally pauses after each full screen, displaying: 

—More— 

at the bottom of the screen. If the user then presses a carriage return, 

one more line is displayed. If the user presses the SPACE bar, another 

full screen is displayed. Other possibilities are described below. 

The command line options are: 

-n An integer which is the size (in lines) of the window which more 
will use instead of the default. 

-c more draws each page by beginning at the top of the screen and 
erasing each line just before it draws on it. ITiis avoids scrolling 
the screen, making it easier to read while more is writing. This 
option is ignored if the terminal does not have the ability to clear 
to the end of a line. 

-d more prompts with the message “Hit space to continue, Rubout to 
abort" at the end of each full screen. This is useful if more is being 
used as a filter in some setting, such as a class, where many users 
may be inexperienced. 

-f This option causes more to count logical, rather than screen lines. 
That is, long lines are not folded. This option is recommended if 
nroff output is being piped through ul, since the latter may generate 
escape sequences. These escape sequences contain characters that 
would ordinarily occupy screen positions, but do not print when 
they are sent to the terminal as part of an escape sequence. Thus 
more may think that lines are longer than they actually are and fold 
lines erroneously. 

-1 Does not treat Ctrl-L (form feed) specially. If this option is not 
given, more pauses after any line that contains a Ctrl-L, as if the 
end of a full screen has been reached. Also, if a file begins with a 
form feed, the screen is cleared before the file is printed. 
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-r Causes carriage returns to be printed as “ A M”. 

-s Squeezes multiple blank lines from the output, producing only one 
blank line. Especially helpful when viewing nroff output, this 
option maximizes the useful information present on the screen. 

-u Normally, more handles underlining, such as that produced by nroff 
m a manner appropriate to the particular terminal: if the terminal 
can perform underlining or has a stand-out mode, more outputs 
appropriate escape sequences to enable underlining or stand-out 
mode for underlined information in the source file. The -u option 
suppresses this processing. 

-v Normally, more ignores control characters that it does not interpret 
in some way. The -v option causes these to be displayed as ~C 
where C is the corresponding printable ASCII character. Non¬ 
printing non-ASCII characters (with the high bit set) are displayed 
in the format M-C, where C is the corresponding character without 
the high bit set. If output is not going to a terminal, more does not 
interpret control characters. 

-w Normally, more exits when it comes to the end of its input. With - 
w however, more prompts and waits for any key to be struck before 
exiting. 

+linenumber 

Starts up at linenumber. 

+/pattern 

Starts up two lines before the line containing the regular expres¬ 
sion pattern. 

more looks in the file /etc/termcap to determine terminal characteris¬ 
tics, and to determine the default window size. On a terminal capable 
of displaying 24 lines, the default window size is 22 lines. 

more looks in the environment variable MORE to preset any flags 
desired. For example, if you prefer to view files using the -c mode of 
operation, the shell command “MORE=-c” in the .profile file causes 
all mvocations of more to use this mode. 

If more is reading from a file, rather than a pipe, a percentage is 
displayed along with the “-More-” prompt. This gives the fraction 
of the file (in characters, not lines) that has been read so far. 

Ofiier sequences which may be entered when more pauses, and their 
effects, are as follows (/ is an optional integer argument, defaulting to 
1 where not specified otherwise): 

i <space> 

Displays / more lines, (or another full screen if no argument is 
given). 


March 15,1989 


MORE-2 





MORE (C) 


MORE (C) 


Ctrl-D , | „ 

Displays 11 more lines (a “scroll”)- If i is given, then the scroll 

size is set to i. 
d Same as Ctrl-D. 

i z Same as entering a space except that i , if present, becomes the 
new window size. 

i s Skips i lines and displays a full screen of lines. 

i f Skips i full screens and displays a full screen of lines. 

qorQ 

Exits from more. 

= Displays the current line number. 

v Starts up the screen editor vi at the current line. Note that vi may 
not be available with your system. 

h or ^ 

Help command; Gives a description of all the more commands. 

//expr „ , . jr 

Searches for the / th occurrence of the regular expression expr. It 
there are less than / occurrences of expr , and the input is a file 
(rather than a pipe), then the position in the file remains 
unchanged. Otherwise, a full screen is displayed, starting two 
lines before the place where the expression was found. The user s 
erase and kill characters may be used to edit the regular expres¬ 
sion. Erasing back past the first column cancels the search com¬ 
mand. 

in Searches for the /th occurrence of the last regular expression 
entered. 

’ (Single quotation mark) Goes to the point from which the last 
search started. If no search has been performed in the current file, 
this command goes back to the beginning of the file. 


!command <t 

Invokes a shell with command. The characters % and ! m com¬ 
mand are replaced with die current filename and the previous 
shell command respectively. If there is no current filename, % is 
not expanded. The sequences “\%” and “\!” are replaced by 
and “!” respectively. 


/ :n 


Skips to the / th next file given in the command line (skips to last 
file if / doesn’t make sense). 
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/':p 


Skips to the / th previous file given in the command line. If this 
command is given m the middle of printing out a file, more goes 
back to the beginning of the file. If / doesn’t make sense, more 
skips back to the first file. If more is not reading from a file the 
bell nng« and nothing else happens. 

Displays the current filename and line number. 


:q or :Q 

Exits from more (same as q or Q). 
. Repeats the previous command. 


e commands take effect immediately. It is not necessary to enter a 
carnage return. Up to the time when the command character itself is 
given, the user may enter the line kill character to cancel the numeri¬ 
cal argument being formed. In addition, the user may enter the erase 
character to redisplay the “-More-(xc%)” message. 

The terminal is set to noecho mode by this program so that the output 
can be continuous. What you enter will not show on your terminal 
except for the slash (/) and exclamation (!) commands. 

? t J le £ tandard output is not a teletype, more acts just like cat, except 
that a header is pnnted before each file (if there is more than one). 

A sample usage of more in previewing nroff output would be 

nroff-ms +2 doc.n I more -s 


Files 


/etc/termcap 

Terminal data base 

/usr/lib/more.help 

Help file 

See Also 


csh(C), sh(C), environ(M) 


Credit 



This utility was developed at the University of California at Berkeley 
and is used with permission. J 
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Notes 

The vi and help options may not be available. 

Before displaying a file, more attempts to detect whether it is a non- 
printable binary file such as a directory or executable binary image. It 
more concludes that a file is unprintable, it refuses to print it. How¬ 
ever, more cannot detect all possible kinds of non-pnntable hies. 
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mv __ 

moves or renames files and directories 

Syntax 

mv [ -f ] filel file2 

mv [ -f ] directory 1 directory2 

mv [ -f ] file ... directory 

Description 


ntv moves (changes the name of) filel to file2 (or directoryl to direc¬ 
torv2). 

iSfile2 already exists, it is removed before filel is moved. Iffile2 has 
a mode which forbids writing, mv prints the mode (see chmod{ S)) and 
reads the standard input to obtain a line. If the line begins with y, the 
move takes place; if not, mv exits. 

In the third form, one or more files are moved to the directory with 
their original filenames. 

No questions are asked when the -f option is given. 
mv refuses to move a file onto itself. 

mv can only rename directories, not physically move them. 
mvdi>(ADM) should be used to move directories within a filesystem. 

See Also 


cp(C), chmod(S), copy(C) 

Notes 


If filel and file2 lie on different file systems, mv must copy the file 
and delete the original. In this case the owner name becomes that of 
the copying process and any linking relationship with other files is 
lost. 
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Standards Conformance 


mv is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 


MV (C) 
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newform _ 

changes the format of a text file 

Syntax 


newform [-s] [-itabspec] [-otabspec] [-bn] [-en] [-pn] [-an] [-f] 
[-cchar] [-In] [file ... ] 

Description 


newform reads lines from the named files , or the standard input if no 
input file is named, and reproduces the lines on the standard output. 
Lines are reformatted in accordance with command line options in 
effect. 

Except for -s, command line options may appear in any order, may be 
repeated, and may be intermingled with files . Command line options 
are processed in the order typed. This means that option sequences 
like “-el5 -160” will yield results different from ‘‘-160 -el5” 
Options are applied to all files on the command line. 

-itabspec Input tab specification: expands tabs to spaces, according 

to the tab specifications given. Tabspec recognizes all tab 
specification forms described below. In addition, tabspec 
may be —, in which newform assumes that the tab 
specification is to be found in the first line read from the 
standard input. If no tabspec is given, tabspec defaults to 
-8. A tabspec of -0 expects no tabs; if any are found, they 
are treated as -1. 

-otabspec Output tab specification: replaces spaces by tabs, accord¬ 
ing to the tab specifications given. The tab specifications 
are the same as for - itabspec . If no tabspec is given, 
tabspec defaults to -8. A tabspec of -0 means that no 
spaces will be converted to tabs on output. 

■1 n Sets the effective line length to n characters. If n is not 

typed, -1 defaults to 72. The default line length without 
the -I option is 80 characters. Note that tabs and back¬ 
spaces are considered to be one character (use -i to 
expand tabs to spaces). 

-bn Truncates n characters from the beginning of the line 

when the line length is greater than the effective line 
length (see -In). The default is to truncate the number of 
characters necessary to obtain the effective line length. 
The default value is used when -b with no n is used. This 
option can be used to delete the sequence numbers from a 
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COBOL program as follows: 

newform -11 -b7 file-name 

The option -11 must be used to set the effective line length 
shorter than any existing line in the file so that the -b 
option is activated. 

-en Truncates n characters from the end of the line. 

-ck Changes the prefix/append character to k. Default charac¬ 

ter for k is a space (see options -p and -c). 

-p n Prefixes n characters (see -ck) to the beginning of a line 

when the line length is less than the effective line length. 
The default is to prefix the number of characters neces¬ 
sary to obtain the effective line length. 

-a /2 Appends n characters to the end of a line. The default is 

to append the number of characters necessary to get the 
effective line length. 

-f Writes the tab specification format line on the standard 

output before any other lines are output. The tab 
specification format line which is printed will correspond 
to the format specified in the last -o option. If no -o 
option is specified, the line which is printed will contain 
the default specification of -8. 

-s Shears off leading characters on each line up to the first 

tab and places up to 8 of the sheared characters at the end 
of the line. If more than 8 characters (not counting the 
first tab) are sheared, the eighth character is replaced by a 
* and any characters to the right of it are discarded. The 
first tab is always discarded. 

An error message and program exit will occur if this 
option is used on a file without a tab on each line. The 
characters sheared off are saved internally until all other 
options specified are applied to that line. The characters 
are then added at the end of the processed line. 


Tabs 

Four types of tab specification are accepted for tabspec : “canned,” 
repetitive, arbitrary, and file. The lowest column number is 1. For 
tabs , column 1 always refers to the leftmost column on a terminal, 
even one whose column markers begin at 0, e.g. the DASI 300, DASI 
300S, and DASI 450. 
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The “canned’ ’ tabs are given as -code where code (and its me aning ) i s 
from the following list: 


■a 


-a2 


-c 


-c2 


1.10.16.36.72 

Assembler, IBM S/370, first format 

1.10.16.40.72 

Assembler, IBM S/370, second format 

1,8,12,16,20,55 
COBOL, normal format 

1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using 
this code, the first typed character corresponds to card 
column 7, one space gets you to column 8, and a tab 
reaches column 12. Files using this tab setup should 
mclude a format specification as follows: 

<:t-c2 m6 s66 d:> 


-c3 1 ,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), with 
more tabs than COBOL -c2. This is the recommended 
format for COBOL. The appropriate format specification 
is: 

<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 

FORTRAN 

-p 1,5,9,13,17,21,25,29,33,37,41,45,53,57,61 


-s 1,10,55 

SNOBOL 

-u 1 12 20 44 

UNIVAC 1100 Assembler 

In addition to these “canned’ ’ formats, three other types exist: 

-n A repetitive specification requests tabs at columns 1+n, 

1+2 *n, etc. Note that such a setting leaves a left margin of 

n columns on TermiNet terminals only. Of particular 
importance is the value -8: this represents the UNIX sys¬ 
tem standard’’ tab setting, and is the most likely tab set¬ 
ting to found at a terminal. It is required for use with 
nroff(CT) -h option for high-speed output. Another spe¬ 
cial case is the value -0, implying no tabs at all. 
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nl,n2,... 


The arbitrary format permits the user to type any chosen 
set of number, separated by commas, in ascending order. 
Up to 40 numbers are allowed. If any number (except the 
first one) is preceded by a plus sign, it is taken as an incre¬ 
ment to be added to the previous value. Thus, the tab lists 
1,10,20,30 and 1,10,+10,+10 are considered identical. 


--file 


If the name of a file is given, newform reads the first line 
of the file, searching for a format specification. If it finds 
one there, it sets the tab stops according to it, otherwise it 
sets them as -8. This type of specification may be used to 
make sure that a tabbed file is printed with correct tab set¬ 
tings. 

Any of the following may be used also; if a given flag occurs more 
than once, the last value given takes effect: 


-T type 


+m« 


newform usually needs to know the type of terminal in 
order to set tabs and always needs to know the type to set 
margins, type is a name listed in termiC T). If no -T flag 
is supplied, newform searches for the $TERM value in 
the environment (see environ (M)). If no type can be 
found, newform tries a sequence that will work for many 
terminals. 

The margin argument may be used for some terminals. It 
causes all tabs to be moved over n columns by making 
column n+1 the left margin. If +m is given without a 
value of n, the value assumed is 10. For a TermiNet, the 
first value in the tab list should be 1, or the margin will 
move even further to the right. The normal (leftmost) 
margin on most terminals is obtained by +m0. The mar¬ 
gin for most terminals is reset only when the +m flag is 
given explicitly. 


Example 


In the following example, newform converts a file named text with 
leading digits, one or more tabs, and text on each line to a file begin¬ 
ning with the text and the leading digits placed at the end of each line 
in vdumn 73 (-s option). All tabs after the first one are cr~anded to 
spaces (-i option). To reach the line length of 72 characters (-1 option), 
spaces are appended to each line up to column 72 (-a option) or lines 
are truncated at column 72 (-e option). To reformat the sample file 
text in this manner, enter: 


newform -s -i -1 -a -e text 


March 15,1989 


NEWFORM-4 







NEWFORM (C) 

Exit Codes 
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0 - normal execution 
1 - for any error 

See Also 


csplit(C) 

Diagnostics 


All diagnostics are fatal. 
usage: ... 
not -s format 
can't open file 
internal line too long 

tabspec in error 


tabspec indirection illegal 


newform was called with a bad option. 
There was no tab on one line. 
Self-explanatory. 

A line exceeds 512 characters after being 
expanded in the internal work buffer. 

A tab specification is incorrectly format¬ 
ted, or specified tab stops are not ascend¬ 
ing. 

A tabspec read from a file (or standard 
input) may not contain a tabspec referenc¬ 
ing another file (or standard input). 


Notes 


newform . normally only keeps track of physical characters; however, 
for the -i and -o options, newform will keep track of backspaces in 
order to line up tabs in the appropriate logical columns. 

newform will not prompt the user if a tabspec is to be read from the 
standard input (by use of -i,~ or -o—). 

If the -f option is used, and the last -o option specified was “-o—” , 
and was preceded by either “-o~” or a “-i~” , the tab specification 
format line will be incorrect. 
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newgrp _ 

logs user into a new group 

Syntax 

newgrp [-] GROUP 

Description 


newgrp changes the group identification of its caller. The same per¬ 
son remains logged in, and the current directory is unchanged, but cal¬ 
culations of access permissions to files are performed with respect to 
the new group ID. 

newgrp without an argument changes the group identification to the 
group in the password file. This changes the caller’s group identifica¬ 
tion back to the original group. 

If the first argument to newgrp is a hyphen (-), the user will actually 
be logged in again as a member of the new group, GROUP, (that is, 
newgrp - GROUP) 

If the first argument to newgrp is a “ -,” but GROUP is not,specified, 
the user will be logged in again as a member of the caller’s original 
group identification according to the password file. 


Files 


/etc/group 

/etc/passwd 

See Also 


login(M), group(F) 

Notes 


The newgrp command executes, but does not fork, a new shell. If your 
login shell is a C shell and you invoke newgrp , you will have to press 
CTRL-D when you wish to log out. Typing the csh (C) logout com¬ 
mand will result in an error message. Note also that the newgrp com¬ 
mand causes the csh history list to start again at 1. 
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newgrp is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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news ____ 

print news items 

Syntax 

news [ -a ] [ -n ] [ -s ] [ items ] 

Description 

news is used to keep the user informed of current events. By conven¬ 
tion, these events are described by files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all 
current files in /usr/news, most recent first, with each preceded by an 
appropriate header, news stores the “currency tune as the modifica¬ 
tion date of a file named .news_time in the user’s home directory (die 
identity of this directory is determined by the environment variable 
$HOME); only files more recent than this currency time are con¬ 
sidered “current.” 

The -a option causes news to print all items, regardless of currency. 
In this case, the stored time is not changed. 

The -n option causes news to report the names of the current items 
without printing their contents, and without changing the stored time. 

The -s option causes news to report how many current items exist, 
without printing their names or contents, and without changing the 
stored time. 

All other arguments are assumed to be specific news items that are to 
be printed. 

If the INTERRUPT key is struck during the printing of a news item, 
printing stops and the next item is started. Another INTERRUPT 
within one second of the first causes the program to terminate. 


Files 


/usr/news/* 

$HOME/.news_time 
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See Also 


NEWS (C) 


profile(M), environ(M) 

Standards Conformance 


news is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 


March 15,1989 


NEWS-2 







NICE (C) 


NICE (C) 


nice __ 

runs a command at a different scheduling priority 


Syntax 

nice [ -increment ] command [ arguments ] 

Description 

The nice command is used to execute a command at a different 
scheduling priority than usual. Each process has a “nice value 
which is used to calculate its priority. Nice values range from 0 to 39, 
with higher nice values resulting in lower priorities. By default, com¬ 
mands have a nice value of 20. nice executes commarui with a nice 
value equal to 20 plus increment. If no increment is given, an incre¬ 
ment of 10 is assumed. 

The super-user may run commands with priority higher than normal 
by using a double negative increment. For example, an argument of 
—10 would decrement the default to produce a nice value of 10, which 
is a higher scheduling priority than the default of 20. 


See Also 


nohup(C), csh(C), nice(S) 


Diagnostics 


nice returns the exit status of command. 


Notes 



If the default nice value plus increment is larger than 39, a nice value 
of 39 will be used. If a nice value less than zero is requested, zero will 
be used. 

Note also that this description of nice applies only to programs run 
under the Bourne Shell. The C-Shell has its own nice command, 
which is documented in csh(C). 

Standards Conformance 

nice is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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nl_ 

adds line numbers to a file 

Syntax 


?* [- bt ype] [-ftype] [-vstart#] [-iincr] [-p] [-Inum] [-ssep] 

[-wwidth] [-nformat] file 

Description 


nl reads lines from the named file, or the standard input if no file is 
named, and reproduces the lines on the standard output. Lines are 
numbered on the left in accordance with the command options in 
effect. 

nl views the text it reads in terms of logical pages. Line numbering is 
reset at the start of each logical page. A logical page consists of a 
header, a body, and a footer section. Empty sections are valid. Dif¬ 
ferent line numbering options are independently available for header, 
body, and footer (e.g. no numbering of header and footer lines while 
numbering blank lines only in the body). 

The start of logical page sections is signaled by input lines co ntainin g 
nothing but the following character(s): 

Page Section Line Contents 

Header \:\:\: 

Body \:\; 

Footer \: 

Unless signaled otherwise, nl assumes the text being read is in a sin¬ 
gle logical page body. 

Command options may appear in any order and may be intermingled 
with an optional filename. Only one file may be named. The options 
are: 

■b type Specifies which logical page body lines are to be num¬ 

bered. Recognized types and their meaning are: a, 
number all lines; t, number lines with printable text only; 
n, no line numbering; pstring , number only lines that con¬ 
tain the regular expression specified in string. Default 
type for logical page body is t (text lines numbered). 
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-h type 

Same as -btype except for header. Default type for logi¬ 
cal page header is n (no lines numbered). 

-f type 

Same as -b type except for footer. Default for logical page 
footer is n (no lines numbered). 

■P 

Does not restart numbering at logical page delimiters. 

-\start# 

Start# is the initial value used to number logical page 
lines. Default is 1. 

-\incr 

Incr is the increment value used to number logical page 
lines. Default is 1. 

-ssep 

Sep is the character(s) used in separating the line number 
and the corresponding text line. Default sep is a tab. 

-wwidth 

Width is the number of characters to be used for the line 
number. Default width is 6. 

-nformat 

Format is the line numbering format. Recognized values 
are: In, left justified, leading zeroes suppressed; rn, right 
justified, leading zeroes suppressed; rz, right justified, 
leading zeroes kept. Default format is rn (right justified). 

-\num 

Num is the number of blank lines to be considered as one. 
For example, -12 results in only the second adjacent blank 
being numbered (if the appropriate -ha, -ba, and/or -fa 
option is set). Default is 1. 


See Also 


pr(C) 

Standards Conformance 


nl is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987 
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nohup _ 

runs a command immune to hangups and quits 

Syntax 


nohup command [ arguments ] 

Description 


nohup executes command with hangups and quits ignored. If output is 
not redirected by die user, it will be sent to nohup.out. If the user 
does not have write permission in the current directory, output is 
redirected to $HOME/nohup.out. 

See Also 


nice(C), signal(S) 

Standards Conformance 


nohup is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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od_ 

displays files in octal format 

Syntax 

od [-bcdox] [ file ] [ [ + ]offset[. ][ b ] ] 

Description 

od displays file in one or more formats as selected by the first argu¬ 
ment. If the first argument is missing, -o is default. The meanings of 
the format options are: 

-b Interprets bytes in octal. 

-c Interprets bytes in ASCII. Certain nongraphic characters 
appear as C escapes: null=\0, backspace=\b, form feed=\f, 
newline=\n, retum=\r, tab=\t; others appear as 3-digit octal 
numbers. 

-d Interprets words in decimal. 

-o Interprets words in octal. 

-x Interprets words in hex. 

The file argument specifies which file is to be displayed. If no file 
argument is specified, the standard input is used. 

The offset argument specifies the offset in the file where displaying is 
to start. This argument is normally interpreted as octal bytes. If . is 
appended, the offset is interpreted in decimal. If b is appended, the 
offset is interpreted in blocks. If the file argument is omitted, the 
offset argument must be preceded by +. 

The display continues until end-of-file. 

See Also 


hd(C), adb(CP) 

Standards Conformance 


od is conformant with: 

AT&TSVTD Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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pack, peat, unpack 

compresses and expands files 

Syntax 


pack [ - ] name ... 
peat name ... 
unpack name ... 

Description 


pack attempts to store the specified files in a compressed form. Wher¬ 
ever possible, each input file name is replaced by a packed file 
name.z with the same access modes, access and modified dates, and 
the owner of name. If pack is successful, name will be removed. 
Packed files can be restored to their original form using unpack or 
peat. 

pack uses Huffman (minimum redundancy) codes on a byte-by-byte 
basis. If the - argument is used, an internal flag is set that causes pack 
to display infomiation about the file compression. Additional 
occurrences of - in place of name will cause the internal flag to be set 
and reset. 

The amount of compression obtained depends on the size of the input 
file and the character frequency distribution. Because a decoding tree 
forms the first part of each .z file, it is usually not worthwhile to pack 
files smaller than three blocks, unless the character frequency distri¬ 
bution is very scattered, which may occur with printer plots or pic¬ 
tures. 

Typically, text files are reduced to 60-75% of their original size. Load 
modules, which use a larger character set and have a more uniform 
distribution of characters, show little compression, the packed ver¬ 
sions being about 90% of the original size. 

pack returns a value that is the number of files that it failed to 
compress. 

No packing will occur if: 

- The file appears to be already packed 

- The filename has more than 12 characters 
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- The file has links 

- The file is a directory 

- The file cannot be opened 

- No disk storage blocks will be saved by packing 

- A file called name. z already exists 

- The .z file cannot be created 

- An I/O error occurred during processing 

The last segment of the filename must contain no more than 12 char¬ 
acters to allow space for the appended .z extension. Directories can¬ 
not be compressed. 

Peat does for packed files what cat(C) does for ordinary files. The 
specified files are unpacked and written to the standard output. Thus 
to view a packed file named name. z use: 

peat name.z 

or just: 

peat name 

To make an unpacked copy, say nnn, of a packed file named name. z 
without destroying name. z, enter the command: 

peat name >nnn 

Peat returns the number of files it was unable to unpack. Failure may 
occur if: 

- The filename (exclusive of the .z) has more than 12 characters 

- The file cannot be opened 

- The file does not appear to be the output of pack 

unpack expands files created by pack. For each file name specified in 
the command, a search is made for a file called name. z (or just name , 
if name ends in .z). If this file appears to be a packed file, it is 
replaced by its expanded version. The new file has the .z suffix 
stripped from its name, and has the same access modes, access and 
modification dates, and owner as those of the packed file. 
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unpack returns a value that is the number of files it was unable to 
unpack. Failure may occur for the same reasons that it may in peat , as 
well as in a file where the “unpacked” name already exists, or if the 
unpacked file cannot be created. 

Standards Conformance 


pack, peat and unpack are conformant with: 

AT&T SVED Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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passwd _ 

change login, modem (dialup shell), filesystem, or 

group password 

Syntax 

passwd [ -mgF ] [ -dluf ] [ -n minimum ] [ -x expiration ] [ -r retries ] 
[name ] 

passwd -s [ -a ] [ name ] 

Description 

The passwd command is used by ordinary users to: 

• Change or delete their own login password. 

• List some of the attributes that apply to their account. 

In addition, system administrators can use the passwd command to: 

• Change or delete any user’s login password. 

• Change or delete modem (dialup shell), filesystem mount, and 
group passwords. 

• Lock or unlock any user’s account. 

• Invalidate (lock) dialup shell, filesystem, and group passwords. 

• List some of the attributes of all users, or any single user. 

• Change some of the attributes of any user. 

However, it is recommended that system administrators use the 
sysadmsh( ADM) Accounts selection to administrate passwords. A 
user is considered to be a system administrator if they are logged in as 
someone who has the auth subsystem authorization. 


Choosing a good password. 

Your login password is one of the most important defenses against 
security breaches. If a malicious person cannot log into a system, it is 
much harder for that person to steal or tamper with your data. Hence, 
by choosing a hard-to-guess password (either of your own invention or 
one suggested by the system), regularly changing it, and keeping it 
secret, you can foil many attacks on your system. 
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In general, a password should : 

• Consist of a mixture of upper- and lower-case letters, digits (0 - 9), 
and other non-leners (such as @, *, -, /, space, tab, and control 
characters). 

• Be changed frequently (at least once every six months to a year, 
and more often as necessary). 

• Be different on different machines. 

• Be easy to remember, so you don’t have to write it down. 

• Be kept secret and known only by you. 

Passwords should not : 

• Be the name of a person, place, or thing; nor should a password be 
the same as any user’s login name, any machine’s name, or the 
name of any group. 

• Be a correctly spelt word, street or telephone number, ZIP or postal 
code; nor should a password be a birthday or anniversary of you or 
anyone you know. 

• Be written down (anywhere! - not on paper or in a file); nor should 
passwords be stored in the function keys of a terminal or memory 
of an intelligent modem. 

• Be told to any other person (not even for use in an “emergency”); 
nor should a password be kept if you suspect someone else knows 
it. 

Spelling a word backwards or appending a digit to a word do not turn 
a poor password choice into a “good” password. However, taking two 
or three unrelated words and combining them with some non-letters is 
a reasonable way of choosing an easy-to-remember but hard-to-crack 
password. On SCO System V, passwords can be up to 80 characters 
long, so nonsensical rhymes (for example) can also be used as pass¬ 
words. 

User login passwords. 

When passwd is used to change or delete the password for user name , 
the old password (if any) is prompted for. (The password is not dis¬ 
played as it is being entered.) System administrators are not prompted 
for the old password unless they are attempting to change their own 
password; the superuser is never prompted for the old password. The 
passwd command can only be used to change or delete the password 
for user name by system administrators and the user authorized to 
change user name's password. Normally, users are authorized to 
change their own password. 
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Depending on how the system administrator has configured the 
account, the user may or may not be able to choose their own pass¬ 
word, or may have a password chosen for them. If they can neither 
choose their own password nor have passwords generated for them, 
the password cannot be changed. If the user is able to do both, passwd 
asks which should be done. 

A password is considered valid until it has expired . Passwords expire 
if they are not changed or deleted before the expiration time has 
passed. Once expired, the user is required to change (not delete) then- 
password the next time they log in. If a user fails to do so before the 
password’s lifetime has passed, the password is considered dead and 
the user’s account is locked. 

Once locked, the user may not log in, may not be su{ C)’ed to, and no 
at( C), batchiC ), or cron( C) jobs for that user may run. Only a system 
administrator can unlock a user with a dead password; a new password 
must be assigned. 

To discourage re-use of the same password, the system administrator 
may set a minimum change time . After changing or deleting a pass¬ 
word, the password may not be changed again (even by a system 
administrator) until at least that much time has elapsed. 

Passwords may be deleted (or changed to be empty) only if the user is 
authorized to not have a password. Users without passwords are not 
recommended. (An empty password is prompted for when logging in, 
but a deleted password is not prompted for at login.) 

If a password is being changed and the user has elected (or is forced) 
to choose a system-generated password, each suggested password is 
printed along with a hyphenated spelling that suggests how the pass¬ 
word could be pronounced. To accept a suggested password, enter the 
password; if entered correctly, passwd will prompt for the suggested 
password to be entered again as confirmation. To reject a suggestion, 
just enter RETURN ; to abort the change altogether, either enter “quit” 
or interrupt passwd. 

If a password is being changed and the user has elected (or is forced) 
to assign a password of their own choosing, the new password is 
prompted for twice. It is checked for being “obvious” after the first 
prompt, and if deemed to be acceptable is prompted for again. If the 
proposed password is successfully entered a second time, it becomes 
the new password for user name. 

Both system-generated and self-chosen passwords are checked for 
being easy-to-guess. See the section on “Checking for obvious pass¬ 
words” (below) for a description of the checks. 
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When dealing with a user’s login password, the following options are 

recognized: 

-d Delete the password. A password may be deleted only if the user 
is authorized to not have a password. System administrators must 
always specify name; otherwise, the name of the user who logged 
in is used. 

-f Force user name to change their password the next time they log 
in. This option may be specified only by system administrators, 
and only when the user’s password is not being changed or deleted; 
name must be explicitly given. 

-1 Lock user name out of the system by applying an administrative 
lock; only system administrators may do this and they must specify 
name. 

-u Remove any administrative lock applied to user name; only system 
administrators may do this and they must specify name. 

-n minimum 

Set the amount of time which must elapse between password 
changes for user name to minimum days. Only system administra¬ 
tors may do this and they must specify name. 

-x expiration 

Set the amount of time which may elapse before the password of 
user name expires to expiration days. Only system administrators 
may do this and they must specify name. Once a password has 
expired, the user must change it the next time they log in. 

-r retries 

Up to retries attempts may be made to choose a new password for 
user frame. 

-s Report the password attributes of user name (or, if the -a option is 
given, of all users). The format of the report is: 

name status mmlddlyy minimum expiration 

where status is PS if the user has a password, LK is the user is 
administratively locked, or NP when the user does not have a pass¬ 
word. The date of the last successful password change (or dele¬ 
tion) is shown as mmlddlyy. If neither name nor -a is specified, the 
name of the user who logged in is assumed. Only system adminis¬ 
trators can examine the attributes of users other than themselves. 
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If no -d, -f, -1, -u, or -s option is specified, the password for user name 
is changed as described above. If no name is given and no option 
which requires name is given, then the name of the user who logged in 
is used. Only the -a option may be specified with the -s option. 


Modem (dialup shell) passwords. 

When a user whose login shell is listed in /etc/d_passwd with a 
(encrypted) password logs in on a terminal line listed in /etc/dialups, 
the password in /etc/djpasswd must be supplied before the login 
succeeds. The -m option to password allows system administrators to 
change, delete, or invalidate (lock) the passwords for login shell 
name: 

-d Delete the password. 

-1 Invalidate (“lock”) the password by arranging so that no matter 
what the user enters, it will not be a valid password. Doing so 
causes the old password to be lost. 

-r retries 

Up to retries attempts may be made to choose a new password. 

The name must always be specified. If name begins with a slash (“/ *) 
the entire shell pathname must match. Otherwise the password for 
every shell whose basename is name is changed. 

If neither the -d nor -1 option is specified, the password is changed. 
The new password is prompted for twice, and must pass checks similar 
to those for login passwords (see below). 


Filesystem mount passwords. 

A password may be required when mounting a filesystem; see mnt(C). 
The -F option to passwd allows system administrators to change, 
delete, or invalidate (lock) the password for filesystem name. The 
options are the same as for modem passwords (see above). 


Group passwords. 

A password may be required when a user changes their current work¬ 
ing group; see newgrp(C). The -g option to passwd allows system 
administrators to change, delete, or invalidate (lock) the password for 
group name. The options are the same as for modem passwords (see 
above). 
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Checking for obvious passwords. 

To discourage poor password choices, various checks are applied to 
reject unacceptable passwords. The checks which are applied depend 
on the type of password being checked and the system’s configuration. 
Most of the checks for being easy-to-guess are configurable; see 
goodpw { ADM). 

The check procedure is as follows (a password is restricted if, accord¬ 
ing to sysadmsh Accounts, it is to be “checked for obviousness”): 

la. 

User login passwords only: The new password must not be the 
same as the old password. The password must not be empty (or be 
deleted) unless the user is not required to have a password. 


lb. 

All other passwords: The new and old password may be the same. 
Empty passwords are treated as deleted passwords and are always 
acceptable. 

2. All (non-empty) passwords: If the password is not empty, it must 
be at least PASSLENGTH characters long (see below). 

3. All (non-empty) passwords: If the goodpw utility can be run, it is 

used to perform all further checks. If the file 

CHECKDIRltype /strength exists (and can be read by goodpw) that 
file is used to modify the default settings in /etc/default/goodpw. 
The CHECKDIR is specified by CHECKDIR in 

/etc/default/passwd and type is the kind of password being 
checked (user, modem, group, or filsys). The strength is the 
degree of checking to be done: secure if the user is restricted (or, 
for all other password types, if the system default is restricted); 
otherwise weak. 

4. When goodpw cannot be run (all passwords): If the password is 
not empty, it must contain at least one character which is not a 
lower case letter (but must not consist solely of digits). 

5. When goodpw cannot be run (user login passwords only): Finally, 
for user login passwords which are restricted, the password must 
not be a palindrome, any user’s login name, the name of any group, 
or a correctly spelt English word (American spelling); see 
accept_pw (S). 

System-generated passwords are not checked unless the user is re¬ 
stricted (see above), in which case the generated password must pass 
the checks in step 5 before it is suggested to the user. Generated pass¬ 
words are never checked by goodpw. The minimum value for 
PASSLENGTH, and the minimum length of a generated password, 
are computed based on the password’s lifetime, delay between login 
attempts, and other factors; see passlen(S). 


September 24,1990 


PASSWD-6 





PASSWD(C) 


PASSWD (C) 


Defaults. 

Several parameters may be specified in /etc/default/passwd. The 
various settings, and their default values are: 

PASSLENGTH=5 

The minimum length of a password. If outside the range 3 to 80 
(inclusive), then it is set to 5. The actual minimum length used by 
passwd is the maximum of this value and a value computed by tak¬ 
ing into consideration the lifetime of the password (and other fac¬ 
tors). 

RETRJ0ES=4 

The maximum number of repeated attempts to change a password 
that has been rejected. If less than 2, then 2 is assumed. 

ONETRY=YES 

If set to YES, a rejected password is added to the stop-list passed 
to goodpw. This prevents simplistic modifications of a rejected 
password from being accepted on a later attempt. 

DESCRIBE=/usr/lib/goodpw/describe 

The contents of this file are shown once (before the new password 
is prompted for) and should describe the the difference between 
acceptable and unacceptable passwords. 

SUMMARY=/usr/lib/goodpw/summary 

The contents of this file are shown each time a password is 
rejected, and should be a (short) reminder of what are and are not 
acceptable passwords. 

CHECKDIR=/usr/lib/goodpw/checks 

A hierarchy of additional checks goodpw should perform, based on 
password type and restrictions (see above). 

GOODPW=/usr/bin/goodpw 

An independent program that applies various checks in an attempt 
to determine whether or not a password is easily guessed. 

The values for the default settings may be changed to reflect the 
system’s security concerns. 

If /etc/default/passwd does not exist or is not readable, the above 
default values are used. 

If the DESCRIBE or SUMMARY file defined in /etc/default/passwd 
does not exist or cannot be read, short (and vague) descriptions or 
summaries are issued instead. In addition, if the user who logged in is 
a system administrator, an error message describing the problem is 
printed. 
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If the GOODPW program does not exist or is not executable, simpler 
checks are done (see above). In addition, if the user who logged in is a 
system administrator, an error message describing the problem is 
printed. 

Files 


/etc/passwd 

List of user accounts. 

Itcb/riiesl Siuthl initial /name 

Protected Password database entry for user name (where the first 
character in name is initial). 

/etc/group 

List of groups. 

/etc/d_passwd 

List of dialup shells and passwords (one per line): 

shell :encrypted-password:reserved 
where shell is the pathname of a login shell as used in /etc/passwd. 

/etc/auth/system/files 
File Control database. 

/etc/auth/system/default 

System Defaults database; contains default parameters. 

/etc/default/passwd 

Configurable settings (see above). 

See Also 


accept_pw(S), authcap(F), authsh(ADM), default(F), goodpw(ADM), 
group(F), login(M), mnt(C), newgrp(C), passlen(S), passwd(F) 
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Notes 

Group passwords should be avoided; see newgrp (C). Not all systems 
support group passwords. 

Not all systems support filesystem mount passwords. 

Not all systems support modem (dialup shell) passwords. 

The -r option is mostly useful during installation to force the newly- 
installed superuser to have a password. 
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paste _ 

merges lines of files 

Syntax 


paste filel file2 ... 
paste -dlel file2 ... 
paste -s [-dlist] filel file2 ... 

Description 


In the first two forms, paste concatenates corresponding lines of the 
given input files filel , file2 , etc. It treats each file as a column or 
columns of a table and pastes them together horizontally (parallel 
merging). It is the counterpart of cat(C) which concatenates verti- 
cally, i.e., one file after the other. In the last form above, paste sub¬ 
sumes the function of an older command with the same name by com¬ 
bining subsequent lines of the input file (serial merging). In all cases, 
lines are glued together with the tab character, or with characters from 
an optionally specified list . Output is to the standard output, so it can 
be used as the start of a pipe, or as a filter, if - is used in place of a 
filename. 

The meanings of the options are: 

-d Without this option, the newline characters of each but the last file 
(or last line in case of the -s option) are replaced by a tab charac¬ 
ter. This option allows replacing the tab character by one or more 
alternate characters. (See below.) 


list 

One or more characters immediately following -d replace the 
default tab as the line concatenation character. The list is used cir¬ 
cularly, i. e. when exhausted, it is reused. In parallel mer g in g (i. e . 
no -s option), the lines from the last file are always terminated with 
a newline character, not from the list. The list may contain the 
special escape sequences: \n (newline), \t (tab), \\ (backslash), and 
\0 (empty string, not a null character). Quoting may be necessary, 
if characters have special meaning to the shell (e.g. to get one 
backslash, use -d'WW "). 

-s Merges subsequent lines rather than one from each input file. Use 
tab for concatenation, unless a list is specified with -d option. 
Regardless of the list, the very last character of the file is forced to 
be a newline. 
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- May be used in place of any filename to read a line from the stan¬ 
dard input. (There is no prompting.) 

Examples 


Is | paste -d" " - 

Is | paste- 

paste -s -d ,, \t\n" file 

See Also 

Lists directory in one column 

Lists directory in four columns 

Combines pairs of lines into lines 

cut(C), grep(C), pr(C) 

Diagnostics 


line too long 

Output lines are restricted to 511 characters. 

too many files 

Except for -s option, no more than 12 input 
files may be specified. 

Standards Conformance 


paste is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 


March 15,1989 


PASTE-2 











PAX (C) 


PAX (C) 


pax _ 

portable archive exchange 

Syntax 


pax [-cimopuvy] [-f archive] [-s replstr] [-t device] [pattern...] 

pax -r [-cimnopuvy] [-f archive] [-s replstr] [-t device] [pattern...] 

pax -w [-adimuvy] [-b blocking] [-f archive] [-s replstr] [-t device] 
[-xformat] [pathname...] 

pax -rw [-ilmopuvy] [-s replstr] [pathname...] directory 

Description 


pax reads and writes archive files which conform to the 
Archive/Interchange File Format specified in IEEE Std. 1003.1- 
1988. pax can also read, but not write, a number of other file formats 
in addition to those specified in the Archive/Interchange File For¬ 
mat description. Support for these traditional file formats, such as V7 
tar and System V binary cpio format archives, is provided for back¬ 
ward compatibility and to maximize portability. 

pax will also support traditional cpio and System V tar interfaces if 
invoked with the name “cpio” or “tar” respectively. See the cpio(C) 
or tar( C) manual pages for more details. 

Combinations of the -r and -w command line arguments specify 
whether pax will read, write or list the contents of the specified 
archive, or move the specified files to another directory. 

The command line arguments are: 

-w writes the files and directories specified by pathname operands 
to the standard output together with the pathname and status 
information prescribed by the archive format used. A directory 
pathname operand refers to the files and (recursively) subdirec¬ 
tories of that directory. If no pathname operands are given, 
then the standard input is read to get a list of pathnames to 
copy, one pathname per line. In this case, only those path¬ 
names appearing on the standard input are copied. 

-r pax reads an archive file from the standard input. Only files 
with names that match any of the pattern operands are selected 
for extraction. The selected files are conditionally created and 
copied relative to the current directory tree, subject to the 
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options described below. By default, the owner and group of 
selected files will be that of the invoking process, and the per¬ 
missions and modification times will be the sames as those in 
the archive. 

The supported archive formats are automatically detected on 
input. The default output format is ustar , but may be overrid¬ 
den by the -x format option described below. 

-rw pax reads the files and directories named in the pathname 
operands and copies them to the destination directory . A direc¬ 
tory pathname operand refers to the files and (recursively) sub¬ 
directories of that directory. If no pathname operands are 
given, the standard input is read to get a list of pathnames to 
copy, one pathname per line. In this case, only those path¬ 
names appearing on the standard input are copied. The direc¬ 
tory named by the directory operand must exist and have the 
proper permissions before the copy can occur. 

If neither the -r or -w options are given, then pax will list the contents 
of the specified archive. In this mode, pax lists normal files one per 
line, hard link pathnames as 

pathname == linkname 

and symbolic link pathnames (if supported by the implementation) as 
pathname -> linkname 

where pathname is the name of the file being extracted, and linkname 
is the name of a file which appeared earlier in the archive. 

If the -v option is specified, then pax list normal pathnames in the 
same format used by the Is utility with the -1 option. Hard links are 
shown as 


<ls -/ listing> == linkname 
and symbolic links (if supported) are shown as 
<ls -/ listing> -> linkname 


pax is capable of reading and writing archives which span multiple 
physical volumes. Upon detecting an end of medium on an archive 
which is not yet completed, pax will prompt the user for the next 
volume of the archive and will allow the user to specify the location 
of the next volume. 
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Options 

The following options are available: 

" a The files specified by pathname are appended to the 

specified archive. 

-b blocking Block the output at blocking bytes per write to the 
archive file. A k suffix multiplies blocking by 1024, a b 
suffix multiplies blocking by 512 and a m suffix multi¬ 
plies blocking by 1048576 (1 megabyte). If not 
specified, blocking is automatically determined on input 
and is ignored for -rw. 

' c Complement the match sense of the the pattern 

operands. 

-d Intermediate directories not explicitly listed in the 

archive are not created. This option is ignored unless 
the -r option is specified. 

“f archive The archive option specifies the pathname of the input 
or output archive, overriding the default of standard 
input for -r or standard output for -w. 

"* Interactively rename files. Substitutions specified by -s 

options (described below) are performed before request¬ 
ing the new file name from the user. A file is skipped if 
an empty line is entered and pax exits with an exit status 
of 0 if EOF is encountered. 

Files are linked rather than copied when possible. 

-m File modification times are not retained. 

-n When -r is specified, but -w is not, the pattern argu¬ 

ments are treated as ordinary file names. Only the first 
occurrence of each of these files in the input archive is 
read. The pax utility exits with a zero exit status after 
all files in the list have been read. If one or more files in 
the list is not found, pax writes a diagnostic to standard 
error for each of the files and exits with a non-zero exit 
status, the file names are compared before any of the -i, 
-s, or -y options are applied. 

"° Restore file ownership as specified in the archive. The 

invoking process must have appropriate privileges to 
accomplish this. 

"P Preserve the access time of the input files after they have 

been copied. 
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•s replstr 


-t device 

-u 

-v 

-x format 

cpio 

ustar 

-y 


File names are modified according to the substitution 
expression using the syntax of ed(C) as shown: 

-s loldlnew/[g p] 

Any non null character may be used as a delimiter (a / is 
used here as an example). Multiple -s expressions may 
be specified; the expressions are applied in the order 
specified terminating with the first successful substitu¬ 
tion. The optional trailing p causes successful mappings 
to be listed on standard error. The optional trailing g 
causes the old expression to be replaced each time it 
occurs in the source string. Files that substitute to an 
empty string are ignored both on input and output. 

The device option argument is an implementation- 
defined identifier that names the input or output archive 
device, overriding the default of standard input for -r 
and standard output for -w. 

Copy each file only if it is newer than a pre-existing file 
with the same name. This implies -a. 

List file names as they are encountered. Produces a ver¬ 
bose table of contents listing on the standard output 
when both -r and -w are omitted, otherwise the file 
names are printed to standard error as they are encoun¬ 
tered in the archive. 

Specifies the output archive format. The input format, 
which must be one of the following, is automatically 
determined when the -r option is used. The supported 
formats are: 

The extended CPIO interchange format specified in 
Extended CPIO Format in IEEE Std. 1003.1-1988. 

The extended TAR interchange format specified in 
Extended TAR Format in IEEE Std. 1003.1-1988. This 
is the default archive format. 

Interactively prompt for the disposition of each file. 
Substitutions specified by -s options (described above) 
are performed before prompting the user for disposition. 
EOF or an input line starting with the character q 
caused pax to exit. Otherwise, an input line starting 
with anything other than y causes the file to be ignored. 
This option cannot be used in conjunction with the -i 
option. 
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Only the last of multiple -for -t options take effect. 

When writing to an archive, the standard input is used as a list of path¬ 
names if no pathname operands are specified. The format is one path¬ 
name per line. Otherwise, the standard input is the archive file, which 
is formatted according to one of the specifications in 
Archive/Interchange File format in IEEE Std. 1003.1-1988, or some 
other implementation-de fined format. 

The user ID and group ID of the process, together with the appropriate 
privileges, affect the ability of pax to restore ownership and permis¬ 
sions attributes of the archived files. (See format-reading utility in 
Archive/Interchange File Format in IEEE Std. 1003.1-1988.) 

The options -a, *c, -d, -i, -1, -p, -t, -u, and -y are provided for func¬ 
tional compatibility with the historical cpio and tar utilities. The 
option defaults were chosen based on the most common usage of these 
options, therefore, some of the options have meanings different than 
those of the historical commands. 


Operands 

The following operands are available: 

directory The destination directory pathname for copies when 
both the -r and -w options are specified. The directory 
must exist and be writable before the copy or and error 
results. 

pathname A file whose contents are used instead of the files named 
on the standard input. When a directory is named, all of 
its files and (recursively) subdirectories are copied as 
well. 

pattern A pattern is given in the standard shell pattern matching 
notation. The default if no pattern is specified is *, 
which selects all files. 

Examples 


The following command 

pax -w -f /dev/rmtO . 

copies the contents of the current directory to tape drive 0. 

The commands 

mkdir newdir 
cd olddir 
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pax -rw. newdir 

copies the contents of olddir to newdir. 

The command 

pax -r -s \//*usr//*„’ -f pax.out 

reads the archive pax.out with all files rooted in "Aisr" in the archive 
extracted relative to the current directory. 

Files 


/dev/tty used to prompt the user for information when the -i or -y 
options are specified. 

See Also 

cpio(C), find(C), tar(C), cpio(M), tar(F) 

Diagnostics 

pax will terminate immediately, without processing any additional 
files on the command line or in the archive. 

pax will exit with one of the following values: 

0 All files in the archive were processed successfully. 

>0 pax aborted due to errors encountered during operation. 

Notes 


Special permissions may be required to copy or extract special files. 

Device, user ID, and group ID numbers larger than 65535 cause addi¬ 
tional header records to be output. These records are ignored by some 
historical version of cpio(C) and tar(C). 

The archive formats described in Archive/Interchange File Format 
have certain restrictions that have been carried over from historical 
usage. For example, there are restrictions on the length of pathnames 
stored in the archive. 

When getting an “Is -1” style listing on tar format archives, link 
counts are listed as zero since the ustar archive format does not keep 
link count information. 
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Copyright (c) 1989 Mark H. Colburn. 

All rights reserved. 

Redistribution and use in source and binary forms are permitted pro¬ 
vided that the above copyright notice is duplicated in all such forms 
and that any documentation, advertising materials, and other materials 
related to such distribution and use acknowledge that the software was 
developed by Mark H. Colburn and sponsored by The USENIX Asso¬ 
ciation. 


THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY 
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT 
LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTI- 
BILITY AND FITNESS FOR A PARTICULAR PURPOSE 


Author 


Mark H. Colburn 

NAPS International 

117 Mackubin Street, Suite 1 

St. Paul, MN 55102 

mark@jhereg.MN.ORG 


Sponsored by The USENIX Association for public distribution. 
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pcpio___ 

copy file archives in and out 

Syntax 

pcpio -o[Bacv] 

pcpio -i[Bcdfmrtuv] [pattern...] 
pcpio -p[adlmruv] directory 

Description 

The pcpio utility produces and reads files in the format specified by 
the cpio Archive/Interchange File Format specified in IEEE Std. 
1003.1-1988. 

The pcpio -i (copy in) utility extracts files from the standard input, 
which is assumed to be the product of a previous pcpio -o . Only files 
with names that match patterns are selected. Multiple patterns may 
be specified and if no patterns are specified, the default for patterns is 
selecting all files. The extracted files are conditionally created and 
copied into the current directory, and possibly any levels below, based 
upon the options described below and the permissions of the files will 
be those of the previous pcpio -o . The owner and group of the files 
will be that of the current user unless the user has appropriate 
privileges, which causes pcpio to retains the owner and group of the 
files of the previous pcpio -o. 

The pcpio -p (pass) utility reads the standard input to obtain a list of 
path names of files that are conditionally created and copied into the 
destination directory based upon the options described below. 

If an error is detected, the cause is reported and the pcpio utility will 
continue to copy other files, pcpio will skip over any unrecognized 
files which it encounters in the archive. 

The following restrictions apply to the pcpio utility: 

1 Pathnames are restricted to 256 characters. 

2 Appropriate privileges are required to copy special files. 

3 Blocks are reported in 512-byte quantities. 


Options 

The following options are available: 
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-B Input/output is to be blocked 5120 bytes to the record. Can 
only be used with pcpio -o or pcpio -i for data that is directed 
to or from character special files. 

-a Reset access times of input files after they have been copied. 
When the -1 option is also specified, the linked files do not have 
their access times reset. Can only be used with pcpio -o or 
pcpio -i. 

-c Write header information in ASCII character for for portability. 
Can only be used with pcpio -i or pcpio -o . Note that this 
option should always be used to write portable files. 

-d Creates directories as needed. Can only be used with pcpio -i 
or pcpio -p. 

-f Copy in all files except those in patterns . Can only be used 
with pcpio -i. 

-1 Whenever possible, link files rather than copying them. Can 
only be used with pcpio -p . 

-m Retain previous modification times. This option is ineffective 
on directories that are being copied. Can only be used with 
pcpio -i or pcpio -p . 

-r Interactively rename files. The user is asked whether to rename 
pattern each invocation. Read and write permissions for 
/dev/tty are required for this option. If the user types a null 
line, the file is skipped. Should only be used with pcpio -i or 
pcpio -o. 

-t Print a table of contents of the input. No files are created. Can 
only be used with pcpio -i. 

-u Copy files unconditionally; usually an older file will not 
replace a new file with the same name. Can only be used with 
pcpio -i or pcpio -p. 

-v Verbose: cause the names of the affected files to be printed. 
Can only be used with pcpio -i . Provides a detailed lis ting 
when used with the -t option. 
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Operands 

The following operands are available: 

patterns Simple regular expressions given in the name-generating 
notation of the shell. 

directory The destination directory. 


Exit Status 

The pcpio utility exits with one of the following values: 

0 All input files were copied. 

2 The utility encountered errors in copying or accessing files or 
directories. An error will be reported for nonexistent files or 
directories, or permissions that do not allow the user to access 
the source or target files. 

It is important to use the -depth option of the find utility to generate 
pathnames for pcpio . This eliminates problems pcpio could have try¬ 
ing to create files under read-only directories. 

The following command: 

Is I pcpio -o > ../newfile 

copies out the files listed by the Is utility and redirects them to the file 

newfile. 

The following command: 

cat newfile I pcpio -id "memo/al" "memo/b*" 

uses the output file newfile from the pcpio -o utility, takes those files 
that match the patterns memo/al and memo/b* , creates the direc¬ 
tories below the current directory, and places the files in the appropri¬ 
ate directories. 

The command 

find. -depth -print I pcpio -pdlmv newdir 

takes the file names piped to it from the find utility and copies or links 
those files to another directory named newdir , while retaining the 
modification time. 
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/dev/tty used to prompt the user for information when the -i or -r 
options are specified. 


See Also 


find(C), pax(C), tar(C), tar(F) 

Copyright 


Copyright (c) 1989 Mark H. Colburn. 

All rights reserved. 

Redistribution and use in source and binary forms are permitted pro¬ 
vided that the above copyright notice is duplicated in all such forms 
and that any documentation, advertising materials, and other materia ls 
related to such distribution and use acknowledge that the software was 
developed by Mark H. Colburn and sponsored by The USENIX Asso¬ 
ciation. 

THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY 
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT 
LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTI- 
BILITY AND FITNESS FOR A PARTICULAR PURPOSE. 

Author 


Mark H. Colburn 

NAPS International 

117 Mackubin Street, Suite 1 

St. Paul, MN 55102 

mark@jhereg.MN.ORG 


Sponsored by The USENIX Association for public distribution. 

Standards Conformance 


pcpio is conformant with: 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 
and NIST FIPS 151-1. 
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pg__ 

file perusal filter for soft-copy terminals 

Syntax 

pg [- number ] [-p string ] [-cefns] [+ linenumber ] [+/ pattern /] 
[files...] 

Description 


The pg command is a filter which allows the examination of files one 
screenful at a time on a soft-copy terminal. (The dash (-) command 
line option and/or NULL arguments indicate that pg should read from 
the standard input.) Each screenful is followed by a prompt. If you 
press the RETURN key, another page is displayed; other possibilities 
are listed below. This command is different from previous paginators 
because it allows you to back up and review something that has 
already passed. 

To determine terminal attributes, pg scans the termcapf F) data base 
for the terminal type specified by the environment variable TERM. If 
TERM is not defined, the terminal type dumb is assumed. 

The command line options are: 

-number Specifies the size (in lines) of the window that pg is to 
use instead of the default. (On a terminal containing 24 
lines, the default window size is 23.) 

-p string Causes pg to use string as the prompt. If the prompt 
str in g contains a “%d”, the first occurrence of “%d” 
in the prompt will be replaced by the current page 
number when the prompt is issued. The default prompt 
string is a colon (:). 

-c Homes the cursor and clears the screen before display¬ 

ing each page. This option is ignored if clear screen 
is not defined for this terminal type in the termcapi F) 
data base. 

. e Causes pg not to pause at the end of each file. 

.f Inhibits pg from splitting lines. In the absence of the -f 

option, pg splits lines longer than the screen width, but 
some sequences of characters in the displayed text (for 
example, escape sequences for underlining) give 
undesirable results. 
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■n Normally, commands must be terminated by pressing 

the RETURN key (ASCII newline character). This 
option causes an automatic end of command as soon as 
a command letter is entered. 

" s Causes pg to display all messages and prompts in stan¬ 

dout mode (usually inverse video). 

+linenumber Starts up at linenumber. 

+lpatternl Starts up at the first line containing the regular expres¬ 
sion pattern. 

The responses that may be entered when pg pauses can be divided into 
three categories: those that cause further perusal, those that search, 
and those that modify the perusal environment. 

Commands which cause further perusal normally take a preceding 
address (an optionally signed number indicating the point from which 
further text should be displayed), pg interprets this address in either 
pages or lines depending on the command. A signed address specifies 
a point relative to the current page or line, and an unsigned address 
specifies an address relative to the beginning of the file. Each com¬ 
mand has a default address if no address is provided. 

The perusal commands and their defaults are as follows: 

(+1 )RETURNkey 

Causes one page to be displayed. The address is specified in 
pages. 

(+ 1 ) 1 . 

With a signed address, causes pg to simulate scrolling the screen, 
forward or backward, the number of lines specified. With an 
unsigned address this command displays a full screen of text 
beginning at the specified line. 

(+1) d or Ctrl-D 

Simulates scrolling half a screen forward or backward. 

The following perusal commands take no address: 

. or Ctrl-L 

Causes the current page of text to be redisplayed. 

$ Displays the last window full in the file. Use with caution when 
the input is a pipe. 

The following commands are available for searching for text patterns 
in the text. The regular expressions described in ed(C) are available. 
They must always be terminated by a newline character, even if the -n 
option is specified. 
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i /pattern I 

Search forward for the ith (default i=l) occurrence of pattern. 
Searching begins immediately after the current page and continues 
to the end of the current file, without wrap-around. 

r pattern' 
it pattern? 

Search backwards for the ith (default i=l) occurrence of pattern. 
Searching begins immediately before the current page and contin¬ 
ues to the beginning of the current file, without wrap-around. The 
caret O notation is useful for terminals which will not properly 
handle die question mark (?). 

After searching, pg displays the line found at the top of the screen. 
You can modify this by appending m or b to the search command to 
leave the line found in the middle or at the bottom of the window from 
now on. Use the suffix t to restore the original situation. 

The following commands modify the environment of perusal: 

in Begins perusing the ith next file in the command line. The 
default value of * is 1. 

ip Begins perusing the ith previous file in the command line. 
The default value of i is 1. 

/ w Displays another window of text. If i is present, set the win¬ 

dow size to /. 

s filename 

Saves the input in the named file. Only the current file being 
perused is saved. The white space between the s sad filename 
is optional. This command must always be terminated by a 
newline character, even if the -n option is specified. 

h Help displays abbreviated summary of available commands. 

qorQ Quitpg. 

Icommand . 

command is passed to the shell, whose name is taken from the 
SHELL environment variable. If this is not available, the 
default shell is used. This command must always be ter¬ 
minated by a newline character, even if the -n option is 
specified. 
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At any time when output is being sent to the terminal, the user can 
press the quit key (normally CtrlA) or the INTERRUPT (BREAK) key. 
This causes pg to stop sending output, and display the prompt. The 
user may then enter one of the above commands in the normal manner. 
Unfortunately, some output is lost when this is done, because any 
characters waiting in the terminal’s output queue are flushed when the 
quit signal occurs. 

If the standard output is not a terminal, then pg acts just like cat( C), 
except that a header is printed before each file (if there is more than 
one). 

Example 


To use pg to read system news, enter: 
news I pg -p “(Page %d):” 


Files 


/etc/termcap Terminal information data base 
/tmp/pg* Temporary file when input is from a pipe 

See Also 


ed(C), grep(C), termcap(M) 

Notes 


If terminal tabs are not set every eight positions, undesirable results 
may occur. 

When using pg as a filter with another command that changes the ter¬ 
minal I/O options terminal settings may not be restored correctly. 

While waiting for terminal input, pg responds to "BREAK and DEL" by 
terminating execution. Between prompts, however, these signals 
interrupt pg 's current task and place you in prompt mode. Use these 
signals with caution when input is being read from a pipe, since an 
interrupt is likely to terminate the other commands in the pipeline. 

The z and / commands used with more are available, and the terminal 
slash (/), caret Q, or question mark (?) may be omitted from the 
searching commands. 
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pg is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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pr __ 

prints files on the standard output 

Syntax 


pr [ options ] [ files ] 

Description 


pr prints the named files on the standard output. If file is -, or if no 
files are specified, the standard input is assumed. By default, the list¬ 
ing is separated into pages, each headed by the page number, date and 
time, and the name of the file. 

By default, columns are of equal width, separated by at least one 
space; lines which do not fit are truncated. If the -s option is used, 
lines are not truncated and columns are separated by the separation 
character. 

If the standard output is associated with a terminal, error messages are 
withheld until pr has completed printing. 

Options may appear singly or combined in any order. Their meanings 
are: 

+k Begins printing with page k (default is 1). 

-k Produces Ar-column output (default is 1). The options -e and -i 
are assumed for multicolumn output. 

-a Prints multicolumn output across the page. 

-m Merges and prints all files simultaneously, one per column 
(overrides the -k, and -a options). 

-d Double-spaces the output. 

-eck Expands input tabs to character positions k+l, 2*k+l, 3*k+l, 
etc. If & is 0 or is omitted, default tab settings at every 8th posi-’ 
tion are assumed. Tab characters in the input are expanded into 
the appropriate number of spaces. If c (any nondigit character) 
is given, it is treated as the input tab character (default for c is 
the tab character). 

m \ck In output , replaces whitespace wherever possible by inserting 
tabs to character positions k+l, 2*k+l, 3*k+l, etc. If k is 0 or 
is omitted, default tab settings at every 8th position are 
assumed. If c (any nondigit character) is given, it is treated as 
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the output tab character (default for c is the tab character). 

-ndk Provides k -digit line numbering (default for k is 5). The number 
occupies the first k +1 character positions of each column of nor¬ 
mal output or each line of -m output. If c (any nondigit charac¬ 
ter) is given, it is appended to the line number to separate it 
from whatever follows (default for c is a tab). 

- w k Sets the width of a line to k character positions (default is 72 for 
equal-width multicolumn output, no limit otherwise). 

-ole Offsets each line by k character positions (default is 0). The 
number of character positions per line is the sum of the width 
and offset. 

•Ik Sets the length of a page to k lines (default is 66). 

-h Uses the next argument as the header to be printed instead of 
the filename. 

-p Pauses before beginning each page if the output is directed to a 
terminal (pr will ring the bell at the terminal and wait for a car¬ 
riage return). 

-f Uses form feed character for new pages (default is to use a 
sequence of linefeeds). Pauses before beginning the first page if 
the standard output is associated with a terminal. 

-r Prints no diagnostic reports on failure to open files. 

-t Prints neither the 5-line identifying header nor the 5-line trailer 
normally supplied for each page. Quits printing after the last 
line of each file without spacing to the end of the page. 

-sc Separates columns by the single character c instead of by the 
appropriate number of spaces (default for c is a tab). 
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The following prints file 1 and Jile2 as a double-spaced, three-column 
listing headed by “file list”: 

pr -3dh "file list" filel Iile2 

The following writes filel on file2, expanding tabs to columns 10, 19 
28,37,...: 

pr -e9 -t <filel >file2 

See Also 

cat(C) 

Standards Conformance 

pr is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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PS_- 

reports process status 

Syntax 

ps [ options ] 

Description 

ps prints certain information about active processes. Entering ps 
without any options calls up uiformation about processes associated 
with the current terminal. The following options control the amount 
and type of information displayed. 

Options 


-e Prints information about all processes. 

-d Prints information about all processes, except process 

group leaders. 

-a Prints information about all processes, except process 

group leaders and processes not associated with a ter¬ 
minal. 

.f Generates a full listing. Normally, a short listing con¬ 

taining only process ID, terminal (“tty”) identifier, 
cumulative execution time, and the command name is 
printed. Under the -f option, ps tries to determine and 
print the process’ original command name and argu¬ 
ments. If it cannot, it prints the short listing version of 
the command name within square brackets. See below 
for the meaning of columns in a full listing. 

-1 Generates a long listing, including status, priority, loca¬ 

tion, and memory usage uiformation for each process. 

-t tlist Restricts listing to data about the processes associated 

with the terminals given in tlist, where tlist can be in 
one of two forms: a list of terminal identifiers 
separated from one another by a comma, or a list of ter¬ 
minal identifiers enclosed in double quotes and 
separated from one another by a comma and/or one or 
more spaces. 
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-p plist Restricts listing to data about processes whose process 
ID numbers are given in plist, where plist is in the same 
format as tlist. 

-u ulist Restricts listing to data about processes whose user ED 
numbers or login names are given in ulist, where ulist 
is m the same format as tlist. In the listing, the numeri¬ 
cal user ID is printed unless the -f option is used, in 
which case the login name is printed. 

-g glist Restricts listing to data about processes whose process 
groups are given in glist, where glist is a list of process 
group leaders and is in the same format as tlist. 

-s swapdev Uses the file swapdev in place of /dev/swap. This is 
useful when examining a core file. 


-n namelist The argument is taken as the name of an alternate 
namelist (/unix is the default). 


Display Columns 


The column headings and the meaning of the columns in a ps listing 
are given below; the letters f and 1 indicate the option (full or long ) 
mat causes the corresponding heading to appear; all means that the 
heading always appears. Note that these two options only determine 
what information is provided for a process; they do not determine 
which processes will be listed. 


a) 


a) 


A status word consisting of flags associated with 
the process. Each flag is associated with a bit in 
the status word. These flags are added to form a 
single octal number. Process flag bits and their 
meanings are: 

01 in core; 

system process; 

locked in core (e.g., for physical I/O); 
being swapped; 

being traced by another process. 


02 

04 

10 

20 


The state of the process: 
0 non-existent; 

S sleeping; 

R running; 

I intermediate; 

Z terminated; 

T stopped; 

B waiting. 
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The user ID number of the process owner; the 
login name is printed under the -f option. Login 
names are truncated after 7 characters. 

The process ID; used when killing a process (see 
kill (C)). 

The process ID of the parent process. 

Processor utilization for scheduling. 

Starting time of the process. 

The priority of the process; higher numbers mean 
lower priority. 

Nice value; used in priority computation. 

The memory addresses (physical page frame 
numbers) of u-area of the process, if resident; oth¬ 
erwise, the disk address. ADDR1 gives the frame 
number of the first half of the u-area, and ADDR2 
gives the number of the second half. 

The size in blocks of the core image of the pro¬ 
cess, but not including the size of text shared with 
other processes. Since this size includes the 
current size of the stack, it will vary as the stack 
size varies. 

WCHAN(l) The event for which the process is waitmg or 

sleeping; if blank, the process is running. 

TTY (all) The controlling terminal for the process. 

TIME (all) The cumulative execution time for the process. 

CMD (all) The command name; the full command name and 

its arguments are printed under the -f option. 

A process that has exited and has a parent, but has not yet been waited 
for by the parent, is marked <defunct>. 
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UID 

(f,D 

PID 

(all) 

PPID 

(f,D 

C 

(f,l) 

STIME 

(f) 

PRI 

(1) 

NI 

(1) 

ADDRl, 

ADDR2 (1) 

SZ 

(1) 


Files 


/unix system namelist 

/dev/mem memory 

/dev searched to find swap device and terminal (“tty”) names. 

See Also ____ 

kill(C), nice(C) 

Notes ____ 

Things can change while ps is running; the picture it gives is only a 
close approximation to reality. 
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Some data printed for defunct processes are irrelevant, but what the 
breley 10 * 1 ^ ^ )r * n ^ ^ or twn-fafaact processes are pretty 


Authorization 


The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the “Using a Trusted Sys- 
tem chapter of the User's Guide for more details. 

Standards Conformance 


ps is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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pstat _ 

reports system information 


Syntax 

pstat [ -aipf ] [ -u ubasel ubase2 ] [ -n namelist ] [ file ] 


Description 


pstat interprets the contents of certain system tables pstat searches 
for these tables in /dev/mem and /dev/kmem. With the. file given, the 
tables are sought in the specified file rather than /dev/mem. The 
required namelist is taken from /unix. Options are: 


Under -p, describe all process slots rather than just active 
ones. 


Print the inode table with these headings: 

LOC The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus: 

L Locked 

U Update time filesystem (F) must be corrected 
A Access time must be corrected 
M File system is mounted here 
W Wanted by another process (L flag is on) 

T Contains a text file 

C Changed time must be corrected 

CNT Number of open file table entries for this inode. 

DEV Major and minor device number of file system in 

which this inode resides. 

INO I-number within the device. 

MODE Mode bits, see chmod(S). 

NLK Number of links to this inode. 

UID User ID of owner. 

SIZ/DEV 

Number of bytes in an ordinary file, or major and 
min or device of special file. 


Prints process table for active processes with these head- 

ings; 

LOC The core location of this table entry. 

S Run state encoded thus: 

0 No process 
1 Waiting for some event 

3 Runnable 

4 Being created 
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5 Being terminated 

6 Stopped under trace 

F Miscellaneous state variables, ORed together: 

01 Loaded 

02 The scheduler process 
04 Locked 
010 

Swapped out 
020 
Traced 
040 

Used in tracing 
0100 

Locked in by lock(S). 

PRI Scheduling priority, see nice(S). 

SIGNAL Signals received (signals 1-16 coded in bits 0-15). 
UID Real user ID. 

TIM Time resident in seconds; times over 127 coded as 
127. 

CPU Weighted integral of CPU time, for scheduler. 

NI Nice level, see nice (S). 

PGRP Process number of root of process group (the 
opener of the controlling terminal). 

PID The process ID number. 

PPID The process ID of parent process. 

ADDR1, ADDR2 

If in core, the physical page frame numbers of the 
u-area of the process. These numbers can be 
translated into the addresses of the u-area, which 
is split and stored in two pages. If swapped out, 
the position in the swap area is measured in multi¬ 
ples of BSIZE bytes. 

WCHAN 

Wait channel number of a waiting process. 

LINK Link pointer in list of runnable processes. 

TEXTP If text is pure, pointer to location of text table 
entry (286 only). 

INODP Pointer to location of shared inode (386 only). 
CLKT Countdown for alarm(S) measured in seconds. 

-u ubasel ubasel 

Print information about a user process. Ubasel and Ubase2 
are the physical page frame numbers of the u-area of the 
process. The numbers may be obtained by using the long 
listing (-1 option) of the ps(C ) command. 

-n namelist 

Use the file namelist as an alternate namelist in place of 

/unix. 


March 15, 1989 


PSTAT-2 




PSTAT (C) 


PSTAT (C) 


-f Print the open file table with these headings: 

LOC The core location of this table entry. 

FLG Miscellaneous state variables: 

R Open for reading 
W Open for writing 
P Pipe 

CNT Number of processes that know this open file. 

INO The location of the inode table entry for this file. 
OFFS The file offset, see Iseek (S). 

Files 


/unix Namelist 

/dev/mem Default source of tables 

See Also 


ps(C), stat(S), filesystem(F) 

Authorization 


The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the “Using a Trusted Sys¬ 
tem” chapter of the User’s Guide for more details. 

Value Added 

pstat is an extension of AT&T System V provided by the Santa Cmz 
Operation. 
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ptar _ 

process tape archives 


Syntax 


ptar -c[bfvw] device block filename... 

ptar -r[bvw] device block {filename..A 

ptar -t[fv] device 

ptar -u[bvw] device block 

ptar -x[flmovw] device {filename...] 

Description 


Tar reads and writes archive files which conform to the 
Archivc/Interdiange File Format specified in IEEE Std. 1003.1- 

lyoo. 


Options 

The following options are available: 


Creates a new archive; writing begins at the beginning 
ot the archive, instead of after the last file. 

Writes names files to the end of the archive. 

Lists the names of all of the files in the archive. 

Causes named files to be added to the archive if they are 
not already there, or have been modified since last writ¬ 
ten into the archive. This implies the -r option. 

Extracts named files from the archive. If a named file 
matches a directory whose contents had been written 
onto the archive, that directory is recursively extracted. 
If a named file in the archive does not exist on the sys¬ 
tem, the file is create with the same mode as the one in 
the archive, except that the set-user-id and get-group-id 
modes are not set unless the user has appropriate 
privileges. 


fi i3 s exist ’ modes ^ not changed except as described 
above The owner, group and modification time are restored if possi- 
bie it no filename argument is given, the entire contents of the 
archive is extracted. Note that if several files with the same name are 
m the archive, the last one will overwrite all earlier ones. 
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-b Causes ptar to use the next argument on the command 

line as the blocking factor for tape records. The default 
is 1; the maximum is 20. This option should only be 
used with raw magnetic tape archives. Normally, the 
block size is determined automatically when reading 
tapes. 

-f Causes ptar to use the next argument on the command 

line as the name of the archive instead of the default, 
which is usually a tape drive. If - is specified as a 
filename ptar writes to the standard output or reads from 
the standard input, whichever is appropriate for the 
options given. Thus, ptar can be used as the head or tail 
of a pipeline. 

_1 Tells ptar to report if it cannot resolve all of the links to 

the files being archived. If -1 is not specified, no error 
messages are written to the standard output. This 
modifier is only valid with the -c, -r and -u options. 

-m Tells ptar not to restore the modification times. The 

modification time of the file will be the time of extrac¬ 
tion. This modifier is invalid with th -t option. 

-o Causes extracted files to take on the user and group 

identifier of the user running the program rather than 
those on the archive. This modifier is only valid with the 
-x option. 

_y Causes ptar to operate verbosely. Usually, ptar does its 

work silently, but the v modifier causes it to print the 
name of each file it processes, preceded by the option 
letter. With the -t option, v gives more information 
about the archive entries than just the name. 

_ w Causes ptar to print the action to be taken, followed by 

the name of the file, and then wait for the user’s 
confirmation. If a word beginning with y is given, die 
action is performed. Any other input means no . This 
modifier is invalid with the -t option. 


Files 


/dev/tty used to prompt the user for information when the -i or -y 
options are specified. 

See Also __ 

cpio(C), dd(C), find(C), pax(C), pcpio(C) 
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PTAR(C) 

Copyright 


PTAR (C) 


Copyright (c) 1989 Mark H. Colbum. 
All rights reserved. 


Red^tnbiition and use in source and binary forms are permitted pro¬ 
ved that the above copyright notice is duplicated in all such forms 
and that any documentation, advertising materials, and other materials 
related to such distribution and use acknowledge that the software was 
developed by Mark H. Colbum and sponsored by The USENIX Asso¬ 
ciation. 


THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY 
EXPRESS OR IMPLIED WARRANTIES, INCLTTDING, WITHOUT 
LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTI- 
BILITY AND FITNESS FOR A PARTICULAR PURPOSE. 


Author 


Mark H. Colbum 
NAPS International 
117 Mackubin Street, Suite 1 
St. Paul, MN 55102 
mark@jhereg.MN.ORG 


Sponsored by The USENIX Association for public distribution. 

Standards Conformance 


ptar is conformant with: 


IEEE POSK Std 1003.1-1988 with 
System Support; 
and NIST FIPS 151-1. 


C Standard Language-Dependent 
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PURGE(C) 


purge _ 

overwrites specified files 


Syntax 


purge [ -f ] [ -r ] [ -v ] [ -m num ] [ -suo ] [ -t type ] ... [ -z ] [ files ]... 


Description 

The command is used to overwrite various parts of the system. It 
overwrites files specified on the command line, or those listed in a 
policy file maintained by the system administrator. The policy file 
defines types of files and devices which are purged as a group. The 
utility can be used to purge individual files, divyy(ADM) divisions, 
fdisk{ ADM) partitions, or other devices like magnetic tapes and flop¬ 
pies. An option even exists to zero memory. 


The optional flags are outlined below: 


-f 

Do not warn about files which are not present or inaccessi- 
ble. Attempts to purge a floppy which is inaccessible (e.g., 
the door is open) will always generate a diagnostic on the 
system console. 

-r 

Recursively purge directories. Without this flag no action is 
taken upon directories. 

-V 

Verbose operation, list the name of each file as it is 
overwritten. 

-m num 

Overwrite each file num times. 

-s 

Overwrite files and devices designated as system in the 
policy file. (Equivalent to “-t system”.) 

-u 

Overwrite files and devices designated as user in the 
policy file. (Equivalent to ”-t user”.) 

-0 

Overwrite other (non-system and non-user) files and 
filesystems. This purges all entries in the policy file which 
are not of either type system or user. This flag, by the 
nature of its implicit definition, has no -t equivalent. 

A. type 

Overwrite the files identified in the policy file as being part 
of group type . 
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" z Writes binary zeroes to system memory, including memory 

buffers of intelligent devices (i.e. disk controller cache, 
etc.). This will close down the system immediately. This 
should only be done from single-user mode, or when no 
users are logged on. The system will autoboot if so 
configured (see autoboot( M)). Only the superuser may use 
this option. 

files Regular, directory or special files to purge. 

Similarly to regular files, most special files can be purged by being 
placed m the policy file or with the command purge Alev /special file. 
Block special files and some character special files can be overwritten. 
The console, ttys, printers and other infinite output devices cannot be 
purged with this command. Disks, floppies and magnetic tapes can be 
overwritten. Tape devices are first erased once and then overwritten 
the specified number of times. 

When both types and files are specified on the command line, all of the 
indicated files are overwritten by the utility. In particular, first the files 
selected from the policy file, and then those specified on the command 
lme, are overwritten. 

Each line in the policy file (/etc/default/purge) designates a file, 
filesystem or device as a member of some type . The syntax of a line is:’ 

file type [ count ] 

The optional count field is the number of times to overwrite file. The 
default count is one. The utility will overwrite file any time the com¬ 
mand 


purge -t type 

is given. 

Blank lines in the policy file and lines beginning with ‘#’ are ignored. 

Files 


/etc/default/purge The policy file 

See Also 


autoboot(ADM), dd(C), hd(C), 
sysadmsh(ADM) 


od(C), nn(C), purge(F), 
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PURGE (C) 

Diagnostics 


PURGE (C) 


purge: warning: invalid entry in policy file (line n) 

An invalid line was read from the policy file where n is the number of 
the incorrectly formatted line. 

purge: filename is a directory 

If the -r switch is not specified no action is taken upon directories and 
this diagnostic is displayed. 

purge: only the superuser can zero memory 

This message is displayed when a user other than the superuser tries to 
use the -z option. 

Notes 


When files are overwritten multiple times, the first pass writes binary 
zeros. Subsequent passes alternate writing binary ones and binary 
zeros. 

After being overwritten, od(C), dd(C) or hd(C) may be used to verify 
that no data remains on the device or in the file. 

Only the superuser may use the -z option to zero the system’s memory. 


Value Added 

purge is an extension of AT&T System V provided by the Santa Cruz 
Operation. 


March 15,1989 


PURGE-3 









PWCHECK (C) 


PWCHECK (C) 


pwcheck 

checks password file 

Syntax 


pwcheck [file] 

Description 


pwcheck scans the password file and checks for any inconsistencies. 
The checks include validation of the number of fields, login name, 
user ID, group ID, and whether the login directory and optional pro¬ 
gram name exist. The default password file is /etc/passwd. 

Files 


/etc/passwd 

See Also 


grpcheck(C), group(F), passwd(F) 
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pwd__ 

prints working directory name 

Syntax 

pwd 

Description 

pwd prints the pathname of the working (current) directory. 

See Also 

cd(C) 

Diagnostics 

“Cannot open and “Read error in indicate possible file system 
trouble. In such cases, see the System Administrator’s Guide for infor¬ 
mation on fixing the filesystem. 

Standards Conformance 


pwd is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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quot _ 

summarizes file system ownership 

^ Syntax 

quot [ option ]... [ filesystem ] 

Description 

quot prints the number of blocks in the named filesystem currently 
owned by each user. If no filesystem is named, the file systems given 
in /etc/mnttab are examined. 


The following options are available: 


■n Processes standard input. This option makes it possible to produce 
a list of all files and their owners with the following command: 

ncheck filesystem I sort +0n I quot -n filesystem 



Prints three columns giving file size in blocks, number of files of 
that size, and cumulative total of blocks in that size or smaller file. 
Data for files of size greater than 499 blocks are included in the 
figures for files of exactly size 499. 


■f Prints a count of the number of files as well as space owned by 
each user. 


Files 


/etc/passwd Gets user names 

/etc/mnttab Contains list of mounted file systems 

See Also 


cmchk(C), du(C), ls(C), machine(HW) 


Notes 


Holes in files are counted as if they actually occupied space. 


March 15,1989 


QUOT-1 













QUOT (C) 


QUOT (C) 


Blocks are reported in 512 byte blocks. 
See also Notes under mount(ADM). 
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random _ 

generates a random number 

^ Syntax _ 

random [-s] [ scale ] 

Description 


random generates a random number on the standard output, and 
returns the number as its exit value. By default, this number is either 
0 or 1 (i.e., scale is 1 by default). If scale is given a value between 1 
and 255, then the range of the random value is from 0 to scale. If scale 
is greater than 255, an error message is printed. 

When the -s, “silent’ ’ option is given, the random number is returned 
as an exit value but is not printed on the standard output. If an error 
occurs, random returns an exit value of zero. 

See Also 



rand(S) 


Notes 


This command does not perform any floating point computations. 
random uses the time of day as a seed. 
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rep _ 

copies files across systems 

Syntax 

rep [ options ] [srcmachine:]srcfile [destmachine:]destfile 


Description 


rep copies files between systems in a Micnet network. The command 
copies the srcmachine: srefile to destmachine:destfile , where 
srcmachine : and destmachine : are optional names of systems in the 
network, and srefile and destfile are pathnames of files. If a machine 
name is not given, the name of the current system is assumed. If - is 
given in place of srefile , rep uses the standard input as the source. 
Directories named on the destination machine must have write per¬ 
mission, and directories and files named on a remote source machine 
must have read permission. 

The available options are: 


Mails and reports completion of the command, whether there is an 
error or not. 

-u [machine:]user 

Any mail goes to the named user on machine. The default 
machine is the machine on which the rep command is completed 
or on which an error was detected. If an alias for user exists in the 
system alias files on that machine , the mail will be redirected to 
the appropriate mailbox(es). Since system alias files are usually 
identical throughout the network, any specified machine will most 
likely be overridden by the aliasing mechanism. To prevent alias¬ 
ing, user must be escaped with at least two \ characters (at least 
four if given as a shell command). 
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rep is useful for transferring small numbers of files across the network. 
The network consists of daemons that periodically awaken and send 
files from one system to another. The network must be installed using 
netutil (ADM) before rep can be used. 

Also, to enable transfer of files from a remote system, either: 

This line should be in fete/default/micnet on the systems in the net¬ 
work: 


rcp=/usr/bin/rcp 

Or, these lines should be in that file: 

executeall 
execpath=PATH= path 

where path must contain / usr/bin . 

Example 


rep -m machine 1 :/etc/mnttab /tmp/vtape 

See Also 

mail(C), micnet(F), netutil(ADM), remote(C) 

Diagnostics 

If an error occurs, mail is sent to the user. 

Notes 

Full pathnames must be specified for remote files. 

rep handles binary data files transparently: no extra options or proto¬ 
cols are needed to handle them. Wildcards are not expanded on the 
remote machine. 
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rcvtrip 

notifies mail sender that recipient is away 


Syntax 

/usr/bin/rcvtrip [-d] [address] 

Description 

The rcvtrip command makes it possible for you to notify the sender of 
a message that you are on holiday and you won’t be answering your 
mail for some time. MMDF runs rcvtrip on your behalf rather than by 
you directly. 

To enable use of rcvtrip, put the following line in your .maildelivery 
file: 


* - pipe R rcvtrip $ (sender) 

Make sure that your .maildelivery file is not writable by anyone but 
you. You may also place a “custom” reply message in a file named 
tripnote. Finally, you should create an empty triplog file. 

When rcvtrip processes a message, it performs the following steps: 

1. Decide if this type of message should receive a reply. 

2. Decide to whom the reply should be sent. 

3. Decide whether this sender has already received a reply. 

The rcvtrip command decides whether this is the type of message that 
should get a reply by looking at the contents of the “Resent-To: , 
“Resent-Cc:”, “To:” and “Cc:” header fields. If the recipient has an 
.alter egos file (described next), then one of the addresses in that file 
must appear in the one of these header fields for a reply to be sent. If 
the recipient does not have an .alter_egos file, then the recipient s 
name or a first-order alias of the recipient’s name (for example, 
dlong~>long) must appear in one of these header fields for a reply to 
be sent. This procedure ensures that rcvtrip will not reply to messages 
sent to mailing lists, unless the recipient’s name (or some variant of 
the recipient’s name) is explicitly mentioned in a header field. 
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If rcvtrip has decided that it should send a reply for the message, then 
it looks at several other address fields to determine to whom the reply 
should be sent. It uses, in order of precedence: 

1. addresses in ‘Resent-Reply-To:’ 

2. addresses in ‘Resent-From:’ and, if present, ‘Resent-Sender:’ 

3. addresses in ‘Reply-To:’ 

4. addresses in ‘From:’ and either ‘Sender:’, if present, or the 
address argument from the command line. 

The rcvtrip command notifies any originator of mail who has not pre¬ 
viously been notified unless you pre-load their address into the triplog 
file (refer to the Files section). The reply begins with some standard 
text (supplied by rcvtrip) followed by whatever text the user has 
placed in the tripnote file (or a canned message if the tripnote file is 
missing). The originators’ names are recorded in triplog, along with 
the date and time the message came in, an indication of whether it was 
answered (‘+’=yes), and the first few characters of the subject. This 
appears as: 

+ jpo@nott.ac.uk Wed Oct 8 16:08 >> about your last message 

Files 

$HOME/tripnote contains a reply message to be sent to those sending 
you mail. 

$HOME/triplog contains a list of who sent a message, what was its 
subject, when it arrived, and if a response was sent. It can also be ini¬ 
tialized by hand to contain the addresses, one per line, which are not 
to receive replies. 

$HOME/logfile, it it exists, becomes an output file for logging diag¬ 
nostic information. If the -d option is specified, then extensive output 
is generated for debugging purposes. It is not a good idea to leave -d 
enabled if this file is left lying around, as the output can be quite 
voluminous. 

$HOME/.alter_egos, an optional file composed of ‘user@domain’ 
lines for all addresses to be considered ‘you’. This is needed if you 
have multiple hosts forwarding their mail to you. If this file is present, 
then the standard comparisons against your username and first-level 
aliases of your username do not occur. 

$HOME/.maildelivery is your mail delivery specification file. The 
previous example shows the line that should be added to .mail- 
delivery to enable use of rcvtrip. In this line, the $(sender) argument 
is optional (but recommended). You may need to give the full path¬ 
name of rcvtrip if it is not in your search path. 

See Also 


maildelivery(F) 
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remote 


executes commands on a remote system 

Syntax 

remote [ - ] [ -f file ] [ -m ] [ -u user] machine 
command [ arguments ] 

Description 

remote is a limited networking facility that permits execution of UNIX 
commands across serial lines. Commands on any connected system 
may be executed from the host system using remote. A command line 
consisting of command and any blank-separated arguments is exe¬ 
cuted on the remote machine. A machine’s name is located in the file 
/etc/systemid. Note that wild cards are not expanded on the remote 
machine, so they should not be specified in arguments. The optional 
-m switch causes mail to be sent to the user telling whether the com¬ 
mand is successful. 

The available options follow: 

A dash signifies that standard input is used as the standard 
input for command on the remote machine. Standard 
input comes from the local host and not from the remote 
machine. 

4 file Use the specified file as the standard input for command 

on the remote machine. The file exists on the local host 
and not on the remote machine. 

-m Mails the user to report completion of the command. By 

default, mail reports only errors. 

-u user Any mail goes to the named user on machine. The default 
machine is the machine on which an error was detected, 
or on which the remote command was completed. The 
mail will be redirected to the appropriate mailbox(es), if 
an alias for user exists in the system alias files on that ma¬ 
chine . Since system alias files are usually identical 
throughout the network, any specified machine will most 
likely be overridden by the aliasing mechanism. To 
prevent aliasing, user must be escaped with at least two \ 
characters (at least four if given as a shell command). 


March 15,1989 


REMOTE-1 








REMOTE (C) 


REMOTE (C) 


Before remote can be successfully used, a network of systems must 
first be set up and the proper daemons initialized using netutil (ADM). 
Also, entries for the command to be executed using remote must be 
added to the / etc!default!micnet files on each remote machine. 

Example 


The following command executes an Is command on the directory 
/tmp of the machine machinel : 

remote machinel Is /tmp 

See Also 


rcp(C), mail(C), netutil(ADM), micnet(F) 

Notes 


The mail command uses the equivalent of remote to send mail 
between machines. 
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rm _ 

removes files or directories 

Syntax 


rm [ -fri ] file ... 

Description 


rm removes the entries for one or more files from a directory. If an 
entry was the last link to the file, the file is destroyed. Removal of a 
file requires write permission in its directory, but neither read nor 
write permission on the file itself. 

If the user does not have write permission on a specified file and the 
standard input is a terminal, the user is prompted for confirmation. 
The file’s name and permissions are printed and a line is read from the 
standard input. If that line begins with y, the file is deleted, otherwise 
the file remains. If the -f option is given or if the standard input is not 
a terminal, no messages are issued; files are simply removed. 

rm will not delete directories unless the -r option is used. 

Options 


The following options are recognized. 

-f When invoked with the -f option, rm does not prompt the user for 
confirmation for files on which the user does not have write per¬ 
mission. The files are simply removed. 

-r The -r (recursive) option causes rm to recursively delete the entire 
contents of the any directories specified, and the directories them¬ 
selves. Note that the rmdir(C) command is a safer way of remov¬ 
ing directories. 

-i The -i (interactive) option causes rm to ask whether to delete each 
file, and if the -r option is in effect, whether to examine each direc¬ 
tory. 

The special option ” can be used to delimit options. For example, 
a file named “-f” could not be removed by rm because the hyphen is 
interpreted as an option; the command rm -f would do nothing, since 
no file is specified. Using rm — -f removes the file successfully. 
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See Also 


RM (C) 


rmdir(C) 

Notes 


It is forbidden to remove the file .. to avoid the consequences of inad- 
vertently doing something like: 

rm -r .* 

It is also forbidden to remove the root directory of a given file system. 

No more than 17 levels of subdirectories can be removed using the -r 
option. 

Standards Conformance 


rm is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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rmdir _ 

removes directories 

Syntax 


rmdir [-p] [-s] dimame ... 

Description 

rmdir removes the entries for one or more subdirectories from a direc¬ 
tory. A directory must be empty before it can be removed. Note that 
the “rm -r dir ” (command is a more dangerous alternative to rmdir.) 
If the parent directory has the sticky bit set, removal occurs only if one 
of the following is true: 

the parent directory is owned by the user 
the dirname directory is owned by the user 
the dirname directory is writable to the user 
the user is the super-user 

The -p option allows users to remove the directory dirname and its 
parent directories which become empty. A message is printed on stan¬ 
dard output as to whether the whole path is removed or part of the path 
remains for some reason. 

The -s option is used to suppress the message printed on standard error 
when -p is in effect. 

rmdir will refuse to remove the root directory of a mounted filesys¬ 
tem. 

See Also 


rm(C) 

Diagnostics 

rmdir returns an exit code of 0 if all the specified directories are 
removed successfully. Otherwise, it returns a non-zero exit code. 

Standards Conformance 


rmdir is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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rsh _ 

invokes a restricted shell (command interpreter) 

^ Syntax 

rsh [ flags ] [ name [ argl ... ] ] 

Description 


rsh is a restricted version of the standard command interpreter sh(C). 
It is used to set up login names and execution environments whose 
capabilities are more controlled than those of the standard shell. The 
actions of rsh are identical to those of sh, except that changing direc¬ 
tory with cd, setting the value of $PATH, using command names con¬ 
taining slashes, and redirecting output using > and » are all disal¬ 
lowed. 


When invoked with the name -rsh, rsh reads the user’s .profile (from 
$HOME/.profile). It acts as the standard sh while doing this, except 
that an interrupt causes an immediate exit, instead of causing a return 
to command level. The restrictions above are enforced after .profile 
is interpreted. 


When a command to be executed is found to be a shell procedure, rsh 
invokes sh to execute it. Thus, it is possible to provide to the end user 
shell procedures that have access to the full power of the standard 
shell, while restricting him to a limited menu of commands; this 
scheme assumes that the end user does not have write and execute per¬ 
missions in the same directory. 


The net effect of these rules is that the writer of the .profile has com¬ 
plete control over user actions, by performing guaranteed setup 
actions, then leaving the user in an appropriate directory (probably not 
the login directory). 

rsh is actually just a lmk to sh and any flags arguments are the same 
as for sh(C). 


The system administrator often sets up a directory of commands that 
can be safely invoked by rsh. 


See Also 


sh(C), profile(M) 
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sddate _ 

prints and sets backup dates 

Syntax 

sddate [ name lev date ] 

Description 


If no argument is given, the contents of the backup date file /etc/ddate 
are printed. The backup date file is maintained by backup (C) and 
contains the date of the most recent backup for each backup level for 
each filesystem. 

If arguments are given, an entry is replaced or made in /etc/ddate. 
name is the last component of the device pathname, lev is the backup 
level number (from 0 to 9), and date is a time in the form taken by 
date( C): 

mmddhhmm[yy] 

Where the first mm is a two-digit month in the range 01-12, dd is a 
two-digit day of the month, hh is a two-digit military hour from 00-23, 
and the final mm is a two-digit minute from 00-59. An optional two- 
digit year, yy, is presumed to be an offset from the year 1900, i.e., 
19yy. 

Some sites may wish to back up file systems by copying them verba¬ 
tim to backup media, sddate could be used to make a “level 0 entry 
in /etc/ddate, which would then allow incremental backups. 

For example: 

sddate rhdO 5 10081520 

makes an /etc/ddate entry showing a level 5 backup of /dev/rhdO on 
October 8, at 3:20 PM. 

Files 


/etc/ddate 
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See Also 


SDDATE(C) 


backup(C), dump(C), date(C) 

Diagnostics 


bad conversion If the date set is syntactically incorrect. 
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sdiff _ 

compares files side-by-side 

Syntax 

sdiff [ options ... ] filel file2 

Description 


sdiff uses the output of diff(C) to produce a side-by-side listing of two 
files indicating those lines that are different. Each line of the two files 
is printed with a blank gutter between them if the lines are identical, a 
< in the gutter if the line only exists in filel , a > in the gutter if the 
line only exists in file2 , and a | for lines that are different. 

For example: 

x I y 

a a 

b < 

c < 

d d 

> c 

The following options exist: 

-w n Uses the next argument, n, as the width of the output 

line. The default line length is 130 characters. 

-1 Only prints the left side of any lines that are identical. 

-s Does not print identical lines. 

-o output Uses the next argument, output , as the name of a third 
file that is created as a user-controlled merging of filel 
and Jile2. Identical lines of filel and file2 are copied to 
output . Sets of differences, as produced by diff(C), are 
printed; where a set of differences share a common 
gutter character. After printing each set of differences, 
sdiff prompts the user with a % and waits for one of the 
following user-typed commands: 

1 Appends the left column to the output file 

r Appends the right column to the output file 
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s Thins on silent mode; does not print identi¬ 
cal lines 

v Turns off silent mode 

e 1 

Calls the editor with the left column 

e r 

Calls the editor with the right column 

e b 

Calls the editor with the concatenation of 
left and right 

e Calls the editor with a zero length file 
q Exits from the program 

On exit from the editor, the resulting file is concatenated 
on the end of the output file. 

See Also 


diff(C),ed(C) 
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sed _ 

invokes the stream editor 

Syntax 


sed [ -n ] [ -e script ] [ -f sfile ] [ files ] 

Description 


sed copies the named files (standard input default) to the standard out¬ 
put, edited according to a script of commands. The -f option causes 
the script to be taken from file sfile ; these options accumulate. If 
there is just one -e option and no -f options, the flag -e may be omit¬ 
ted. The -n option suppresses the default output. A script consists of 
editing commands, one per line, of the following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern 
space (unless there is something left after a D command), applies in 
sequence all commands whose addresses select that pattern space, 
and at the end of the script copies the pattern space to the standard 
output (except under -n) and deletes the pattern space. 

A semicolon (;) can be used as a command delimiter. 

Some of the commands use a hold space to save all or part of the pat¬ 
tern space for subsequent retrieval. 

An address is either a decimal number that counts input lines cumula¬ 
tively across files, a $ that addresses the last line of input, or a context 
address, i.e., a / regular expression / in the style of ed(C) modified as 
follows: 

- In a context address, the construction \?regular expression ? , where 
? is any character, is identical to / regular expression /. Note that 
in the context address \xabc\xdefx, the second x stands for itself, 
so that the regular expression is abcxdef. 

- The escape sequence \n matches a newline embedded in the pat¬ 
tern space. 

- A period . matches any character except the terminal newline of 
the pattern space. 

- A command line with no addresses selects every pattern space. 


March 15,1989 


SED-1 







SED(C) 


SED(C) 


- A command line with one address selects each pattern space that 
matches the address. 

- A command line with two addresses selects the inclusive range 
from the first pattern space that matches the first address through 
the next pattern space that matches the second. (If the second 
address is a number less than or equal to the line number first 
selected, only one line is selected.) Thereafter, the process is 
repeated, looking again for the first address. 

Editing commands can be applied only to nonselected pattern spaces 
by use of the negation function ! (below). 

In the following list of functions, the maximum number of permissible 
addresses for each function is indicated in parentheses. 

The text argument consists of one or more lines, all but the last of 
which end with backslashes to hide the newlines. Backslashes in text 
are treated like backslashes in the replacement string of an s com¬ 
mand, and may be used to protect initial blanks and tabs against the 
stripping that is done on every script line. The rjile or wfile argument 
must terminate the command line and must be preceded by exactly 
one blank. Each wfile is created before processing begins. There can 
be at most 10 distinct wfile arguments. 

(1) a\ 

text Appends text , placing it on the output before reading the 

next input line. 

(2) b label Branches to the : command bearing the label. If label is 

empty, branches to the end of the script. 

(2)c\ 

text Changes text by deleting the pattern space and then 

appending text. With 0 or 1 address or at the end of a 2- 
address range, places text on the output and starts the next 
cycle. 

(2) d Deletes the pattern space and starts the next cycle. 

(2) D Deletes the initial segment of the pattern space through 

the first newline and starts the next cycle. 

(2) g Replaces the contents of the pattern space with the con¬ 
tents of the hold space. 

(2)G Appends the contents of the hold space to the pattern 
space. 

(2) h Replaces the contents of the hold space with the contents 

of the pattern space. 
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(2)H Appends the contents of the pattern space to the hold 
space. 

d)i\ 

text Insert. Places text on the standard output. 

(2) 1 Lists the pattern space on the standard output with non¬ 

printing characters spelled in two-digit ASCII and long 
lines folded. 

(2) n Copies the pattern space to the standard output. Replaces 

the pattern space with the next line of input. 

(2) N Appends the next line of input to the pattern space with an 
embedded newline. (The current line number changes.) 

(2) p Prints (copies) the pattern space on the standard output. 

(2)P Prints (copies) the initial segment of the pattern space 
through the first newline to the standard output. 

(1) q Quits sed by branching to the end of the script. No new 

cycle is started. 

(2) r rfile Reads the contents of rfile and places them on the output 

before reading the next input line. 

(2)s /regular expression!replacement!flags 

Substitutes the replacement string for instances of the 
regular expression in the pattern space. Any character 
may be used instead of /. For a more detailed description, 
see ed(C). Flags is zero or more of: 

n n=l-512. Substitute for just the nth occurrence of the 
regular expression. 

g Globally substitutes for all nonoverlapping instances 
of the regular expression rather than just the first one. 

p Prints the pattern space if a replacement was made. 

w wfile 

Writes the pattern space to wfile if a replacement was 
made. 

(2) t label Branches to the colon (:) command bearing label if any 
substitutions have been made since the most recent read¬ 
ing of an input line or execution of a t command. If label 
is empty, t branches to the end of the script. 
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(2) w wfile 

Writes the pattern space to wfile. 

(2)x 

Exchanges the contents of the pattern and hold spaces. 

(2) y /string 1 Istring2 / 

Replaces all occurrences of characters in stringl with the 
corresponding characters in string2. The lengths of 
stringl and string2 must be equal. 

(2)! function 

Applies the function (or group, if function is {) only to 
lines not selected by the address(es). 

(0): label 

This command does nothing; it bears a label for b and t 
commands to branch to. 

(D = 

Places the current line number on the standard output as a 
line. 

(2){ 

Executes the following commands through a matching } 
only when the pattern space is selected. 

(0) 

An empty command is ignored. 

See Also 



awk(C), ed(C), grep(C) 

Notes 

This command is explained in detail in the User’s Guide. 

Standards Conformance 

sed is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 


March 15,1989 


SED-4 





SETCOLOR (C) 


SETCOLOR (C) 


setcolor, setcolour _ 

set screen color and other screen attributes 

Syntax 


setcolor -[nbrgopc] argument [argument] 

Description 


setcolor allows the user to set the screen color on a color screen. Both 
foreground and background colors can be set independently in a range 
of 16 colors, setcolor can also set the reverse video and graphics 
character colors, setcolor with no arguments produces a usage mes¬ 
sage that displays all available colors, then resets the screen to its pre¬ 
vious state. 


For example, the following strings are possible colors. 


blue magenta 

lt_blue lt_magenta 
cyan white 

lt_cyan hi_white 


brown black 
yellow gray 

green red 

lt_green lt_red 


The following flags are available. In the arguments below, “color” is 
taken from the above list. 


-n Set the screen to “normal” white characters on black background. 
color [color] 

Set the foreground to the first color. Sets background to second 
color if a second color choice is specified. 

-b color 

Set the background to the specified color. 

-r color 

Set the foreground reverse video characters to the first color. Set 
reverse video characters’ background to second color. 

-g color 

Set the foreground graphics characters to the first color. Set graph¬ 
ics characters’ background to second color. 

-o Set the color of the screen border (overscan region). 
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-p pitch duration 

Set the pitch and duration of the bell. Pitch is the period in 
microseconds, and duration is measured in fifths of a second. 
When using this option, a control-G (bell) must be echoed to the 
screen for the command to work. For example: 

setcolor -p 2500 2 
echo ~G 


-c first last 

Set the first and last scan lines of the cursor. (For more informa¬ 
tion see screen^ HW).) 

Notes 


The ability of setcolor to set any of these described functions is ulti¬ 
mately dependent on the ability of devices to support them, setcolor 
emits an escape sequence that may or may not have an effect on mono¬ 
chrome devices. 

Occasionally changing the screen color can help prolong the life of 
your monitor. 

See Also 


screen(HW) 

Value Added 


setcolor and setcolour are extensions of AT&T System V provided by 
the Santa Cruz Operation. 
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setkey_ 

assigns the function keys 

Syntax 

setkey keynum string 

Description 

The setkey command assigns the given ANSI string to be the output 
of the computer function key given by keynum. For example, the 
command: 

setkey 1 date 

assi g ns the string "date" as the output of function key 1. The string 
can contain control characters, such as a newline character, and 
should be quoted to protect it from processing by the shell. For exam¬ 
ple, the command: 

setkey 2 "pwd; lc\n" 

assigns the command sequence "pwd ; lc" to function key 2. Notice 
how the newline character is embedded in the quoted string. This 
causes the commands to be carried out when function key 2 is pressed. 
Otherwise, the Enter key would have to be pressed after pressing the 
function key, as in the previous example. 

setkey translates ' into ", which, when passed to the screen driver, is 
interpreted as a right angle bracket (>), or greater than key. 

Notes 


setkey works only on the console keyboard. 

The string mapping table is where the function keys are defined. It is 
an array of 512 bytes (typedef strmap t ) where null terminated strings 
can be put to redefine the function keys. The first null terminated 
string is assigned to the first string key, the second to the second string 
key, and so on. There is one string mapping table per multiscreen. 

Although the size of the setkey string mapping table is 512 bytes, 
there is a limit of 30 characters that can be assigned to any individual 
function key. 
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Assigning more than 512 characters to the string mapping table causes 
the function key buffer to overflow. When this happens, the sequences 
sent by the arrow keys are overwritten, effectively disabling them. 
Once the function key buffer overflows, the only way to enable the 
arrow keys is to reboot the system. 

The table below lists the keynum values for the function keys: 



For a table of the escape sequences, refer to keyboard(HW). 
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Files 

/bin/setkey 

See Also 

keyboard(HW) 
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sh 

invokes the shell command interpreter 

Syntax 

sh [ -aceiknrstuvx ] [ args ] 

Description 


The shell is the standard command programming language that exe¬ 
cutes commands read from a terminal or a file. See Invocation below 
for the meaning of arguments to the shell. 


Commands 

A simple-command is a sequence of nonblank words separated by 
blanks (a blank is a tab or a space). The first word specifies the name 
of the command to be executed. Except as specified below, the 
remaining words are passed as arguments to the invoked command. 
The command name is passed as argument 0 (see exec (S)). The value 
of a simple-command is its exit status if it terminates normally, or 
(octal) 1000+status if it terminates abnormally (i.e., if the failure pro¬ 
duces a core file). See signal (S) for a list of status values. 

A pipeline is a sequence of one or more commands separated by a 
vertical bar (I). (The caret (*), is an obsolete synonym for the verti¬ 
cal bar and should not be used in a pipeline.) The standard output of 
each command but the last is connected by a pipe(S ) to the standard 
input of the next command. Each command is run as a separate pro¬ 
cess; the shell waits for the last command to terminate. 

A list is a sequence of one or more pipelines separated by ;, &, &&, 
or 11, and optionally terminated by ; or & . Of these four symbols, ; 
and & have equal precedence, which is lower than that of && and 11. 
The symbols && and 11 also have equal precedence. A semicolon (;) 
causes sequential execution of the preceding pipeline; an ampersand 
(&) causes asynchronous execution of the preceding pipeline (i.e., the 
shell does not wait for that pipeline to finish). The symbol && (11 ) 
causes the list following it to be executed only if the preceding pipe¬ 
line returns a zero (nonzero) exit status. An arbitrary number of new¬ 
lines may appear in a list , instead of semicolons, to delimit com¬ 
mands. 
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A command is either a simple-command or one of the following com¬ 
mands. Unless otherwise stated, the value returned by a command is 
that of the last simple-command executed in the command: 


for name [ in word ... ] 

do 

list 

done 


Each time a for command is executed, name is set to the next word 
taken from the in word list. If in word is omitted, then the for com¬ 
mand executes the do list once for each positional parameter that is 
set (see Parameter Substitution below). Execution ends when there 
are no more words in the list. 


case word in 

[ pattern [ I pattern ]...) list 

;; ] 

esac 

A case command executes the list associated with the first pat¬ 
tern that matches word . The form of the patterns is the same as that 
used for filename generation (see Filename Generation below). 


if list then 
list 

[ elif list then 
list ] 

[ else list ] 
fi 

The list following if is executed and, if it returns a zero exit status, the 
list following the first then is executed. Otherwise, the list following 
elif is executed and, if its value is zero, the list following the next 
then is executed. Failing that, the else list is executed. If no else list 
or then list is executed, then the if command returns a zero exit status. 


while list 
do 

list 

done 

A while command repeatedly executes the while list and, if the exit 
status of the last command in the list is zero, executes the do list ; oth¬ 
erwise the loop terminates. If no commands in the do list ore exe¬ 
cuted, then the while command returns a zero exit status; until may be 
used in place of while to negate the loop termination test. 


(list) 

Executes list in a subshell. 


{list;} 

list is simply executed. 
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name () {list;} 

Define a function which is referenced by name. The body of func¬ 
tions is the list of commands between { and }. Execution of func¬ 
tions is described later (see Execution.) 


The following words are recognized only as the first word of a com¬ 
mand and when not quoted: 

if then else elif fi case esac for while until do done { } 


Comments 

A word beginning with # causes that word and all che following char¬ 
acters up to a newline to be ignored. 


Command Substitution 

The standard output from a command enclosed in a pair of grave 
accents ( N v ) may be used as part or all of a word; trailing newlines 
are removed. 

No interpretation is done on the command string before the string is 
read, except to remove backslashes (\) used to escape other characters. 
Backslashes may be used to escape grave accents (') or other 
backslashes and are removed before the command string is read. 
Escaping grave accents allows nested command substitution. If the 
command substitution lies withing a pair of double quotes (” 6 ... 6 11 ), 
backslashes used to escape a double quote (V) will be removed; other¬ 
wise, they will be left intact. 

If a backslash is used to escape a newline character, both the 
backslash and the newline are removed (see the section on “Quot¬ 
ing”). In addition, backslashes used to escape dollar signs (\$) are 
removed. Since no interpretation is done on the command string 
before it is read, inserting a backslash to escape a dollar sign has not 
effect. Backslashes that precede characters other than \,', ”, newline, 
and $ are left intact. 


Parameter Substitution 

The character $ is used to introduce substitutable parameters. There 
are two types of parameters, positional and keyword. If parameter is a 
digit, it is a positional parameter. Positional parameters may be 
assigned values by set. Keyword parameters, (also known as vari¬ 
ables) may be assigned values by writing: 
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name-value [ name-value ]... 

Pattern-matching is not performed on value . There cannot be a func¬ 
tion and a variable with the same name. 

${ parameter } 

A parameter is a sequence of letters, digits, or underscores (a 
name), a digit, or any of the characters *, @, #, ?, -, $, and !. The 
value, if any, of the parameter is substituted. Hie braces are 
required only when parameter is followed by a letter, digit, or 
underscore that is not to be interpreted as part of its name. A name 
must begin with a letter or underscore. If parameter is a digit then 
it is a positional parameter. If parameter is * or @, then all the 
positional parameters, starting with $1, are substituted (separated 
by spaces). Parameter $0 is set from argument zero when the shell 
is invoked. 

%{parameter :-word} 

If parameter is set and is not a null argument, substitute its value; 
otherwise substitute word. 

%{parameter \-word} 

If parameter is not set or is null, then set it to word ; the value of 
the parameter is then substituted. Positional parameters may not 
be assigned to in this way. 

${parameter :?word} 

If parameter is set and is not a null argument, substitute its value; 
otherwise, print word and exit from the shell. If word is omitted, 
the message “parameter null or not set’ ’ is printed. 

${parameter :+word} 

If parameter is set and is not a null argument, substitute word\ oth¬ 
erwise substitute nothing. In the above, word is not evaluated 
unless it is to be used as the substituted string, so that in the fol¬ 
lowing example, pwd is executed only if d is not set or is null: 

echo ${d:- s pwd' } 

If the colon (:) is omitted from the above expressions, then the shell 
only checks whether parameter is set. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal 

- Flags supplied to the shell on invocation or by the set command 

? The decimal value returned by the last synchronously executed 
command 
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$ The process number of this shell 

! The process number of the last background command invoked 
The following parameters are used by the shell: 

CDPATH 

Defines search path for the cd command. See the section Special 
Commands , “cd”. 

HOME 

The default argument (home directory) for the cd command 

PATH 

The search path for commands (see Execution below) 

MAIL 

If this variable is set to the name of a mail file, then the shell 
informs the user of the arrival of mail in the specified file 

MAILCHECK 

This parameter specifies how often (in seconds) the shell will 
check for the arrival of mail in the files specified by the 
MAILPATH or MAIL parameters. The default value is 600 
seconds (10 minutes). If set to 0, the shell will check before each 
prompt. 

MAILPATH 

A colon (:) separated list of file names. If this parameter is set, the 
shell informs the user of the arrival of mail in any of the specified 
files. Each file name can be followed by % and a message that 
will be printed when the modification time changes. The default 
message is you have mail. 

PS1 

Primary prompt string, by default “$ ” 

PS2 

Secondary prompt string, by default “> ” 

IFS 

Internal field separators, normally space, tab, and newline 
SHACCT 

If this parameter is set to the name of a file writable by the user, 
the shell will write an accounting record in the file for each shell 
procedure executed. Accounting routines such as acctcom(PiDM) 
and accton(ADM) can be used to analyze the data collected. This 
feature does not work with all versions of the shell. 
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SHELL 

When the shell is invoked, it scans the environment (see Environ¬ 
ment below) for this name. If it is found and there is an ‘r’ in the 
file name part of its value, the shell becomes a restricted shell. 

The shell gives default values to PATH, PS1, PS2, and IFS, while 
HOME and MAIL are not set at all by the shell (although HOME is set 
by login( M)). 


Blank Interpretation 

After parameter and command substitution, the results of substitution 
are scanned for internal field separator characters (those found in IFS) 
and split into distinct arguments where such characters are found. 
Explicit null arguments ("" or '') are retained. Implicit null argu¬ 
ments (those resulting from parameters that have no values) are 
removed. 


Filename Generation 

Following substitution, each command word is scanned for the char¬ 
acters *, ?, and [. If one of these characters appears, the word is 
regarded as a pattern . The word is replaced with alphabetically sorted 
filenames that match the pattern. If no filename is found that matches 
the pattern, the word is left unchanged. The character . at the start of a 
filename or immediately following a /, as well as the character / itself, 
must be matched explicitly. These characters and their matching pat¬ 
terns are: 

* Matches any string, including the null string. 

? Matches any single character. 

Matches any one of the enclosed characters. A pair of characters 
separated by - matches any character lexically between the pair, 
inclusive. If the first character following the opening bracket ([) is 
an exclamation mark (!), then any character not enclosed is 
matched. 


Quoting 

The following characters have a special meaning to the shell and 
cause termination of a word unless quoted: 

;&()!"<> newline space tab 
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A character may be quoted (i.e., made to stand for itself) by preceding 
it with a \. The pair \newline is ignored. All characters enclosed 
between a pair of single quotation marks except a single quota¬ 
tion mark, are quoted. Inside double quotation marks (" "), parameter 
and command substitution occurs and \ quotes the characters \, v , ”, 
and $. ”$*" is equivalent to "$1 $2 whereas “$@” is 
equivalent to "$1” "$2" ... 


Prompting 

When used interactively, the shell prompts with the value of PS1 
before reading a command. If at any time a newline is typed and 
further input is needed to complete a command, the secondary prompt 
(i.e., the value of PS2) is issued. 

Spelling Checker 

When using cd(C ) the shell checks spelling. For example, if you 
change to a different directory using cd and misspell the directory 
name, the shell responds with an alternative spelling of an existing 
directory. Enter “y” and press RETURN (or just press RETURN) to 
change to the offered directory. If the offered spelling is incorrect, 
enter “n”, then retype the command line. In this example the sh(C) 
response is boldfaced: 

$ cd /usr/spol/uucp 

cd /usr/spool/uucp?y 
ok 


Input/Output 


Before a command is executed, its input and output may be redirected 
using a special notation interpreted by the shell. The following may 
appear anywhere in a simple-command or may precede or follow a 
command. They are not passed on to the invoked command; substitu¬ 
tion occurs before word or digit is used: 

<word Use file word as standard input (file descriptor 0). 

>word Use file word as standard output (file descriptor 1). 

If the file does not exist, it is created; otherwise, it is 
truncated to zero length. 


>word Use file word as standard output. If the file exists, 

output is appended to it (by first seeking the 
end-of-file); otherwise, the file is created. 


<[ - ]word The shell input is read up to a line that is the same as 
word , or to an end-of-file. The resulting document 
becomes the standard input. If any character of word 
is quoted, no interpretation is placed upon the 
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characters of the document; otherwise, parameter 
and command substitution occurs, (unescaped) \new- 
line is ignored, and \ must be used to quote the char¬ 
acters \, $, v , and the first character of word. If - is 
appended to ®all leading tabs are stripped from 
word and from the document. 

<&digit The standard input is duplicated from file descriptor 

digit (see dup{ S)). Similarly for the standard output 
using >. 

<&- The standard input is closed. Similarly for the stan¬ 

dard output using >. 

If one of the above is preceded by a digit, the file descriptor created is 
that specified by the digit (instead of the default 0 or 1). For example: 

... 2>&1 

creates file descriptor 2 that is a duplicate of file descriptor 1. 

If a command is followed by &, the default standard input for the 
command is the empty file /dev/null. Otherwise, the environment for 
the execution of a command contains the file descriptors of the invok¬ 
ing shell as modified by input/output specifications. 


Environment 

The environment (see environ (M)) is a list of name-value pairs that is 
passed to an executed program in the same way as a normal argument 
list. The shell interacts with the environment in several ways. On 
invocation, the shell scans the environment and creates a parameter 
for each name found, giving it the corresponding value. Executed 
commands inherit the same environment. If the user modifies the 
values of these parameters or creates new ones, none of these affect 
the environment unless the export command is used to bind the shell’s 
parameter to the environment. The environment seen by any executed 
command is composed of any unmodified name-value pairs originally 
inherited by the shell, minus any pairs removed by unset, plus any 
modifications or additions, all of which must be noted in export com¬ 
mands. 

The environment for any simple-command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 

TERM=450 cmd args 
and 
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(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the -k flag is set, all keyword arguments are placed in the environ¬ 
ment, even if they occur after the command name. 


Signals 

The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by &; otherwise signals have the 
values inherited by the shell from its parent, with the exception of sig¬ 
nal 11. See the trap command below. 

Execution 

Each time a command is executed, the above substitutions are carried 
out. If the command name does not match a Special Command, but 
matches the name of a defined function, the function is executed in the 
shell process (note how this differs from the execution of shell pro¬ 
cedures). The positional parameters $1, $2,... are set to the arguments 
of the function. If the command name matches neither a Special Com¬ 
mand nor the name of a defined function, a new process is created and 
an attempt is made to execute the command via exec (S). 

The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are separated 
by a colon (:). The default path is :/bin:/usr/bin (specifying the 
current directory, /bin, and /usr/bin, in that order). Note that the 
current directory is specified by a null pathname, which can appear 
immediately after the equal sign or between the colon delimiters any¬ 
where else in the path list. If the command name contains a /, then the 
search path is not used. Otherwise, each directory in the path is 
searched for an executable file. If the file has execute permission but 
is not an a.out file, it is assumed to be a file containing shell com¬ 
mands. A subshell (i.e., a separate process) is spawned to read it. A 
parenthesized command is also executed in a subshell. 

Shell procedures are often used by users running the csh. However, if 
the first character of the procedure is a # (comment character), csh 
assumes the procedure is a csh script, and invokes /bin/csh to execute 
it. Always start sh procedures with some other character if csh users 
are to run the procedure at any time. This invokes the standard shell 
Ibinlsh. 

The location in the search path where a command was found is 
remembered by the shell (to help avoid unnecessary execs later). If 
the command was found in a relative directory, its location must be 
re-determined whenever the current directory changes. The shell for¬ 
gets all remembered locations whenever the PATH variable is changed 
or the hash -r command is executed (see hash in next section). 
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Special Commands 

Input/output redirection is permitted for these commands: 

: No effect; the command does nothing. A zero exit code is 
returned. 


Reads and executes commands from file and returns. The search 
path specified by PATH is used to find the directory containing file. 

break [ n ] 

Exits from the enclosing for or while loop, if any. If n is specified, 
it breaks n levels. 

continue [ n ] 

Resumes the next iteration of the enclosing for or while loop. If n 
is specified, it resumes at the n -th enclosing loop. 

cd [ arg ] 

Changes the current directory to arg. The shell parameter HOME 
is the default arg. The shell parameter CDPATH defines the 
search path for the directory containing arg. Alternative directory 
names are separated by a colon (:). The default path is <null> 
(specifying the current directory). Note that the current directory 
is specified by a null path name, which can appear immediately 
after the equal sign or between the colon delimiters anywhere else 
in the path list. If arg begins with a /, the search path is not used. 
Otherwise, each directory in the path is searched for arg. 

If the shell is reading its commands from a terminal, and the specified 
directory does not exist (or some component cannot be searched), 
spelling correction is applied to each component of directory , in a 
search for the “correct” name. The shell then asks whether or not to 
try and change directory to the corrected directory name; an answer of 
n means “no”, and anything else is taken as “yes”. 

echo [ arg ] 

Writes arguments separated by blanks and terminated by a newline 
on the standard output. Arguments may be enclosed in quotes. 
Quotes are required so that the shell correctly interprets these spe¬ 
cial escape sequences: 

\b Backspace 

\c Prints line without newline. 

\f Form feed 
\n Newline 
\r Carriage return 
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\t Tab 

\v Vertical tab 
\\ Backslash 

\n The 8-bit character whose ASCII code is the 1, 2 or 3-digit octal 
number n must start with a zero 

eval [ arg ... ] 

The arguments are read as input to the shell and the resulting 
command(s) executed. 

exec [ arg ... ] 

The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output arguments 
may appear and, if no other arguments are given, cause the shell 
input/output to be modified. 

exit [ n ] 

Causes a shell to exit with the exit status specified by n. If n is 
omitted, the exit status is that of the last command executed. An 
end-of-file will also cause the shell to exit. 

export [ name ... ] 

The given name s are marked for automatic export to the environ¬ 
ment of subsequently executed commands. If no arguments are 
given, a list of all names that are exported in this shell is printed. 

getopts 

Use in shell scripts to support command syntax standards (see 
intro (C)); it parses positional parameters and checks for legal 
options. See getopts (C) for usage and description. 

hash [ -r ] [ name ... ] 

For each name, the location in the search path of the command 
specified by name is determined and remembered by the shell. The 
-r option causes the shell to forget all remembered locations. If no 
arguments are given, information about remembered commands is 
presented. Hits is the number of times a command has been 
invoked by the shell process. Cost is a measure of the work 
required to locate a command in the search path. There are certain 
situations which require that the stored location of a command be 
recalculated. Commands for which this will be done are indicated 
by an asterisk (*) adjacent to the hits information. Cost will be 
incremented when the recalculation is done. 

newgrp [arg ... ] 

Equivalent to exec newgrp arg ... 
pwd 

Print the current working directory. See pwd(C) for usage and 
description. 

read [ name ... ] 

One line is read from the standard input and the first word is 
assigned to the first name, the second word to the second name, 
etc., with leftover words assigned to the last name. The return 
code is 0 unless an end-of-file is encountered. 


March 15,1989 


SH-11 



SH (C) 


SH (C) 


readonly [ name ... ] 

The given names are marked readonly and the values of the these 
names may not be changed by subsequent assignment. If no argu¬ 
ments are given, a list of all readonly names is printed. 

return [ n ] 

Causes a function to exit with the return value specified by n. If n 
is omitted, the return status is that of the last command executed. 

set [ -eknuvx [ arg ... ] ] 

-a Mark variables which are modified or created for export. 

-e If the shell is noninteractive, exits immediately if a command 
exits with a nonzero exit status. 

-f Disables file name generation. 

-h Locates and remembers function commands as functions are 
defined (function commands are normally located when the 
function is executed). 

-k Places all keyword arguments in the environment for a com¬ 
mand, not just those that precede the command name. 

-n Reads commands but does not execute them. 

-u Treats unset variables as an error when substituting. 

-v Prints shell input lines as they are read. 

-x Prints commands and their arguments as they are executed. 
Although this flag is passed to subshells, it does not enable trac¬ 
ing in those subshells. 

- Does not change any of the flags; useful in setting $1 to -. 

Using + rather than - causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current set 
of flags may be found in $-. The remaining arguments are posi¬ 
tional parameters and are assigned, in order, to $1, $2, ... If no 
arguments are given, the values of all names are printed. 

shift 

The positional parameters from $2 ... are renamed $1... 
test 

Evaluates conditional expressions. See test l C) for usage and 
description. 

times 

Prints the accumulated user and system times for processes run 
from the shell, 
trap [ arg ] [ n ] ... 

arg is a command to be read and executed when the shell receives 
signal(s) n . (Note that arg is scanned once when the trap is set and 
once when the trap is taken.) Trap commands are executed in 
order of signal number. The highest signal number allowed is 16. 
Any attempt to set a trap on a signal that was ignored on entry to 
the current shell is ineffective. An attempt to trap on signal 11 
(memory fault) produces an error. If arg is absent, all trap(s) n are 
reset to their original values. If arg is the null string, this signal is 


March 15, 1989 


SH-12 




SH (C) 


SH (C) 


ignored by the shell and by the commands it invokes. If n is 0, the 
command arg is executed on exit from the shell. The trap com¬ 
mand with no arguments prints a list of commands associated with 
each signal number. 

type [ name ... ] 

For each name , indicate how it would be interpreted if used as a 
command name. 

ulimit [ n ] 

imposes a size limit of n blocks on files written by the shall and its 
child processes (files of any size may be read). Any user may 
decrease the file size limit, but only the super-user (root) can 
increase the limit. With no argument, the current limit is printed. 

If no option is given and a number is specified, -f is assumed, 
unset [ name ... ] 

For each name, remove the corresponding variable or function. The 
variables PATH, PS1, PS2, MAILCHECK and IFS cannot be unset. 

umask [ ooo ] 

The user file-creation mask is set to the octal number ooo where o is 
an octal digit (see umask(C)). If ooo is omitted, the current value of 
the mask is printed. 

wait [ n ] 

Waits for the specified process to terminate, and reports the termina¬ 
tion status. If n is not given, all currently active child processes are 
waited for. The return code from this command is always 0. 

Invocation 

If the shell is invoked through exec (S) and the first character of argu¬ 
ment 0 is -, commands are initially read from /etc/profile and then 
from $HOME/.profile, if such files exist. Thereafter, commands are 
read as described below, which is also the case when the shell is 
invoked as /bin/sh. The flags below are interpreted by the shell on 
invocation only; note that unless the -c or -s flag is specified, the first 
argument is assumed to be the name of a file containing commands, 
and the remaining arguments are passed as positional parameters to 
that command file: 

-c string If the -c flag is present, commands are read from string. 

■s If the -s flag is present or if no arguments remain, com¬ 

mands are read from the standard input. Any remaining 
arguments specify the positional parameters. Shell output 
is written to file descriptor 2. 

-t If the -t flag is present, a single command is read and exe¬ 

cuted, and the shell exits. This flag is intended for use by 
C programs only and is not useful interactively. 

-i If the -i flag is present or if the shell input and output are 

attached to a terminal, this shell is interactive . In this 
case, TERMINATE is ignored (so that kill 0 does not kill 
an interactive shell) and INTERRUPT is caught and 
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ignored (so that wait is interruptible). In all cases, QUIT 
is ignored by the shell. 

-r If the -r flag is present, the shell is a restricted shell (see 

rsh( C)). 

The remaining flags and arguments are described under the set com¬ 
mand above. 

Exit Status 


Errors detected by the shell, such as syntax errors, cause the shell to 
return a nonzero exit status. If the shell is being used noninterac- 
tively, execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed. See the exit com¬ 
mand above. 

Files 


/etc/profile 

$HOME/.profile 

/tmp/sh* 

/dev/null 

See Also 


cd(C), env(C), login(M), newgrp(C), rsh(C), test(C), umask(C), 
dup(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
a.out(F), profile(M), environ(M) 

Notes 


The command readonly (without arguments) produces the same out¬ 
put as the command export. 

If « is used to provide standard input to an asynchronous process 
invoked by &, the shell gets mixed up about naming the input docu¬ 
ment; a garbage file /tmp/sh* is created and the shell complains about 
not being able to find that file by another name. 

If a command is executed, and a command with the same name is 
installed in a directory in the search path before the directory where 
the original command was found, the shell will continue to exec the 
original command. Use the hash command to correct this situation. 

If you move the current directory or one above it, pwd may not give 
the correct response. Use the cd command with a full path name to 
correct this situation. 


system default profile if none is present 
read by login shell at login 
temporary file for « 
source of empty file 


March 15, 1989 


SH-14 








SH (C) 


SH (C) 


When a sh(C ) user logs in, the system reads and executes commands 
in /etc/profile before executing commands in the user’s 
$HOMELprofile. You can, therefore, modify the environment for all 
sh(C) users on the system by editing /etc/profile. 

The shell doesn’t treat the high (eighth) bit in the characters of a com¬ 
mand line argument specially, nor does it strip the eighth bit from the 
characters of error messages. Previous versions of the shell used the 
eighth bit as a quoting mechanism. 

Existing programs that set the eighth bit of characters in order to quote 
them as part of the shell command line should be changed to use of the 
standard shell quoting mechanisms (see the section on “Quoting”). 

Words used to filenames in input/output redirection are not interpreted 
for filename generation (see the section on “File Name Generation”). 
For example, cat filel > a* will create a file named a*. 

Because commands in pipelines are run as separate processes, vari¬ 
ables set in a pipeline have no effect on the parent shell. 

If you get the error message: 

fork failed - too many processes 

try using the wait( C) command to clean up your background pro¬ 
cesses. If this doesn’t help, the system process table is probably full or 
you have too many active foreground processes (there is a limit to the 
number of processes that can associated with your login, and to the 
number the system can keep track of.). 

Warnings 


If a command is executed, and a command with the same name is 
installed in a directory in the search path before the directory where 
the original command was found, the shell will continue to exec the 
original command. Use the hash command to correct this situation. 

Not all processes of a 3- or more-stage pipeline are children of the 
shell, and thus cannot be waited for. 

For wait n y if n is not an active process id, all your shell’s currently 
active background processes are waited for and the return code will be 
zero. 

Standards Conformance 


sh is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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shl__ 

shell layer manager 
Syntax 

shl 

Description 

shl allows a user to interact with more than one shell from a single ter¬ 
minal. The user controls these shells, known as layers , using the com¬ 
mands described below. 

The current layer is the layer that can receive input from the key¬ 
board. Other layers attempting to read from the keyboard are blocked. 
Output from multiple layers is multiplexed onto the terminal. To have 
the output of a layer blocked when it is not current, the stty(C) option 
loblk may be set within the layer. 

The stty character swtch (set to ~Z if NUL) is used to switch control to 
shl from a layer, shl has its own prompt, >, to help distinguish it from 
a layer. 

A layer is a shell that has been bound to a virtual tty device 
(/dev/sxt???). The virtual device can be manipulated like a real tty 
device using stty{C) and ioctl( S). Each layer has its own process 
group id. 

Definitions 


A name is a sequence of characters delimited by a blank, tab or new- 
line. Only the first eight characters are significant. The names (1) 
through (7) cannot be used when creating a layer. They are used by 
shl when no name is supplied. They may be abbreviated to just the 
digit. 

Commands 


The following commands may be issued from the shl prompt level. 
Any unique prefix is accepted. 

create [ name ] 

Create a layer called name and make it the current layer. If no 
argument is given, a layer will be created with a name of the form 
(#) where # is the last digit of the virtual device bound to the layer. 
The shell prompt variable PS1 is set to the name of the layer 
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followed by a space, or, if superuser, the name followed by a sharp 
(#) and a space. A maximum of seven layers can be created. 

block name [ name ... ] 

For each name, block the output of the corresponding layer when it 
is not the current layer. This is equivalent to setting the stty option 
loblk within the layer. 

delete name [ name ... ] 

For each name, delete the corresponding layer. All processes in 
the process group of the layer are sent the SIGHUP signal (see sig- 
nal( 2)). 

help (or ?) 

Print the syntax of the shl commands, 
layers [ -1 ] [ name ...] 

For each name, list the layer name and its process group. The -1 
option produces a/w(l)-like listing. If no arguments are given, in¬ 
formation is presented for all existing layers. 

resume [ name ] 

Make the layer referenced by name the current layer. If no argu¬ 
ment is given, the last existing current layer will be resumed. 

toggle 

Resume the layer that was current before the last current layer, 
unblock name [ name ... ] 

For each name, do not block the output of the corresponding layer 
when it is not the current layer. This is equivalent to setting the 
stty option loblk within the layer. 

quit 

Exit shl. All layers are sent the SIGHUP signal. 
name 

Make the layer referenced by name the current layer. 


Files 


/dev/sxt??? 

SSHELL 


Virtual tty devices 

Variable containing path name of the shell to 
use (default is /bin/sh). 


See Also 


ioctl(S), mkdev(ADM), sh(C), signal(S), stty(C), sxt(M) 
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It is inadvisable to kill shl. 

If shl does not ran properly on a particular terminal, you may have to 
set istrip for that terminal’s line by entering the following command 
at the terminal: 

stty istrip 

By default, the Operating System is not configured for shell layers. To 
add this to kernel, use the command: 

mkdev shl 

This executes a script which prompts you for the number of sessions 
desired. The script also allows you to relink the kernel. The new ses¬ 
sion limit becomes effective after the kernel is rebooted. (For more in¬ 
formation, see mkdev( ADM).) 

Standards Conformance 


shl is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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sleep 

suspends execution for an interval 

Syntax 

sleep time 

Description 

sleep suspends execution for time seconds. It is used to execute a 
command after a certain amount of time as in: 

(sleep 105; command)& 

or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 

See Also 


alarm(S), sleep(S) 

Notes 


It is recommended that time be less than 65536 seconds. If this 
amount is exceeded, time will be arbitrarily set to some value less 
than 65536 seconds. 

Standards Conformance 


sleep is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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slot 


read the microchannel configuration registers 

Syntax 

/etc/slot [ -a adid] [ -s slot ] [-f adnamesfile ] 

Description 

slot displays the contents of the configuration POS registers on a 
microchannel architecture machine, and names the adapter cards 
currently configured in each slot. 

For each of the eight adapter slots, slot shows the slot number, the 
unique adapter id (four digits in hexadecimal from registers 0x100 and 
0x101), the contents of the remaining six POS registers (two hexade¬ 
cimal digits each), followed by the adapter card name. 

The default slot display looks similar to this: 


Slot 

AdID 

Regs 

0x102-0x107 

Adapter Name 

1 

— 


— 

Empty Slot 

2 

Oflf 

01 3b 

f7 31 ffff 

Adaptec 1640 SCSI Host Adapter 

3 

_ 


— 

Empty Slot 

4 

6bbc 

8100 

00 85 ffff 

Apricot Synchronous Communications Adapter 

5 

6bba 

8100 

00 b6 ffff 

Apricot Ethernet Controller 

6 

dfbf 

05 02 

ffff ffff 

IBM 6157 Streaming Tape 

7 

— 



Empty Slot 

8 

— 

— 


Empty Slot 


The available slot options select a particular adapter id, a particular 
slot, or select an alternative names file. 


-a adid 

shows only the information for those slots in which an adapter of 
that id is configured (no display if no such adapter), adid should be 
specified in hexadecimal. For example, /etc/slot -a dfbf shows 
only those slots which contain an IBM 6157 Streaming Tape 
adapter card. 

-s slot 

shows only the information for that slot (no display if that slot is 
empty). For example, /etc/slot -s 6 shows only the information for 
slot 6. 

-f adnamesfile 

the text displayed by /etc/slot is normally read from the file 
letc/default/slot. This option redirects it to read from an alternative 
file adnamesfile. For example, /etc/slot -f /dev/null shows only the 
register contents of occupied slots, without the accompanying text, 
which can be useful when processing the output automatically in a 
shell script. 
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Diagnostics 


Returns 0 upon successful completion. Returns 1 if incorrectly 
invoked, if the machine is not a microchannel architecture machine 
(/dev/mcapos unreadable), if the selected adapter id is not found, or if 
the selected slot is empty. 

Files 


/etc/default/slot This file contains the headers, footers and adapter 
names shown by the slot utility. The text in this file may be 
translated, or extended as new adapters are announced. The display of 
header lines, empty slots, and footers may be suppressed by omitting 
their text. 

/dev/mcapos The slot utility reads the 64 bytes of MCA POS register 
configuration information from this device. 

Notes 


If run on a machine which does not have the microchannel architec¬ 
ture, slot reports “not an MCA machine” and exits with diagnostic 1. 

If an adapter id is not listed in I etc I default! slot, slot reports “Unknown 
card” for that slot. The System Administrator should add an entiy for 
that adapter id to !etc!default!slot. 

slot reports what adapter is configured in which slot. No indication is 
given as to whether that adapter is working, nor whether that adapter 
is connected to working hardware. No indication is given as to 
whether the current SCO System V kernel supports that adapter, nor 
whether a driver for that adapter is available for SCO System V. 

slot cannot be used to change the configuration shown. To change the 
configuration, use the setup disk supplied with your machine. Consult 
the hardware documentation supplied with your machine for details 
concerning the use of the setup disk. 

See Also 


hwconfig(C) 

Value Added 


slot is an extension of AT&T System V provided by The Santa Cruz 
Operation, Inc. 
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sort 

sorts and merges files 

Syntax 

sort [-emu] [-ooutput] [-ykmem] [-zrecsz] [-dfiMnr] [-btx] [+posl] 
[-pos2] [files] 

Descr i ption 


sort sorts lines of all the named files together and writes the result on 
the standard output. The standard input is read if - is used as a file 
name or if no input files are named. 

Comparisons are based on one or more sort keys extracted from each 
line of input. By default, there is one sort key, the entire input line, 
and ordering is determined by the collating sequence defined by the 
locale (see locale (M)). 

The following options alter the default behavior: 

-c Check that the input file is sorted according to the ordering 
rules; give no output unless the file is out of sort. 

-m Merge only, the input files are already sorted. 

-u Unique: suppress all but one in each set of lines having equal 
keys. This option can result in unwanted characters placed at 
the end of the sorted file. 

-o output 

The argument given is the name of an output file to use instead 
of the standard output. This file may be the same as one of the 
inputs. There may be optional blanks between -o and output. 

-ykmem 

The amount of main memory used by the sort has a large impact 
on its performance. Sorting a small file in a large amount of 
memory is a waste. If this option is omitted, sort begins using a 
system default memory size, and continues to use more space as 
needed. If this option is presented with a value, kmem, sort will 
start using that number of kilobytes of memory, unless the 
administrative minimum or maximum is violated, in which case 
the corresponding extremum will be used. Thus, -yO is 
guaranteed to start with minimum memory. By convention, -y 
(with no argument) starts with maximum memory. 
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-z recsz 

Causes sort to use a buffer size of recsz bytes for the merge 
phase. Input lines longer than the buffer size will cause sort to 
terminate abnormally. Normally, the size of the longest line 
read during the sort phase is recorded and this maximum is used 
as the record size during the merge phase, eliminating the need 
for the -z option. However, when the sort phase is omitted (-c or 
-m options) a system default buffer size is used, and if this is not 
large enough, the -z option should be used to prevent abnormal 
termination. 

The following options override the default ordering rules. 

-d “Dictionary” order: only letters, digits and blanks (spaces and 
tabs) are significant in comparisons. Dictionary order is defined 
by the locale setting (see locale (M)). 

-f Fold lower case letters into upper case. Conversion between 
lowercase and uppercase letters are governed by the locale set¬ 
ting (see locale (M)). 

-i Ignore non-printable characters in non-numeric comparisons. 
Non-printable characters are defined by the locale setting (see 
locale (M)). 

-M Compare as months. The first three non-blank characters of the 
field are folded to upper case and compared so that “JAN” < 
“FEB” < ... < “DEC”. Invalid fields compare low to “JAN”. 
The -M option implies the -b option (see below). 

-n An initial numeric string, consisting of optional blanks, an 
optional minus sign, and zero or more digits with optional 
decimal point, is sorted by arithmetic value. The -n option 
implies the -b option (see below). Note that the -b option is 
only effective when restricted sort key specifications are in 
effect. 

-r Reverse the sense of comparisons. 

When ordering options appear before restricted sort key specifications, 
the requested ordering rules are applied globally to all sort keys. 
When attached to a specific sort key (described below), the specified 
ordering options override all global ordering options for that key. 

The notation +posl -pos2 restricts a sort key to one beginning at posl 
and ending at pos2. The characters at positions posl and pos2 are 
included in the sort key (provided that pos2 does not precede posl ). A 
missing -pos2 means the end of the line. 
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Specifying posl and pos2 involves the notion of a field (a minimal 
sequence of characters followed by a field separator or a newline). By 
default, the first blank (space or tab) of a sequence of blanks acts as 
the field separator. All blanks in a sequence of blanks are considered 
to be part of the next field; for example, all blanks at the beginning of 
a line are considered to be part of the first field. The treatment of field 
separators can be altered using the options: 

-tx Use x as the field separator character; x is not considered to be 
part of a field (although it may be included in a sort key). Each 
occurrence of x is significant (e.g., xx delimits an empty field). 

-b Ignore leading blanks when determining the starting and ending 
positions of a restricted sort key. If the -b option is specified 
before the first +posl argument, it will be applied to all +posI 
arguments. Otherwise, the b flag may be attached indepen¬ 
dently to each +posl or -pos2 argument (see below). 

Posl and pos2 each have the form m.n optionally followed by one or 
more of the flags b, d, f, i, n, or r. A starting position specified by 
+m.n is interpreted to mean the n+lst character in the w+lst field. A 
missing .n means .0, indicating the first character of the w+lst field. If 
the b flag is in effect, n is counted from the first non-blank in the 
w+lst field; +m.0b refers to the first non-blank character in the w+lst 
field. 

A last position specified by -m.n is interpreted to mean the nth charac¬ 
ter (including separators) after the last character of the mth field. A 
missing .n means .0, indicating the last character of the mth field. If 
the b flag is in effect, n is counted from the last leading blank in the 
w+lst field; -w.lb refers to the first non-blank in the w+lst field. 

When there are multiple sort keys, later keys are compared only after 
all earlier keys compare equal. Lines that otherwise compare equal 
are ordered with all bytes significant. 

Examples 

Sort the contents of infile with the second field as the sort key: 
sort +1-2 infile 

Sort, in reverse order, the contents of infilel and infile2 , placing the 
output in outfile and using the first character of the second field as the 
sort key: 

sort -r -o outfile +1.0 -1.2 infilel infile2 

Sort, in reverse order, the contents of infilel and infile2 using the first 
non-blank character of the second field as the sort key: 


March 15,1989 


SORT-3 





SORT (C) 


SORT (C) 


sort-r+l.Ob-1.1b infile 1 infile2 

Print the password file (passwd( F)) sorted by the numeric user ID (the 
third colon-separated field): 

sort -t: +2n -3 /etc/passwd 

Print the lines of the already sorted file infile , suppressing all but the 
first occurrence of lines having the same third field (the options -um 
with just one input file make the choice of a unique representative 
from a set of equal lines predictable): 

sort -um +2 -3 infile 


Files 


/usr/tmp/stm??? 

See Also 


coltbl(M), comm(C), join(C), locale(M), uniq(C) 

Diagnostics 


Comments and exits with non-zero status for various trouble condi¬ 
tions (e.g., when input lines are too long), and for disorders discovered 
under the -c option. When the last line of an input file is missing a 
newline character, sort appends one, prints a warning message, and 
continues. 

Standards Conformance 


sort is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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spell, hashmake, spellin, hashcheck 

finds spelling errors 

Syntax 

spell [ -v ] [ -b ] [ -x ] [ -1 ] [ -i ] [ +local_file ] [ files ] 

/usr/lib/spell/hashmake 
/usr/Iib/spell/spellin n 
/usr/lib/spell/hashcheck spellingjist 

Description 

spell collects words from the named files and looks them up in a spel¬ 
ling list. Words that neither occur among nor are derivable (by apply¬ 
ing certain inflections, prefixes, and/or suffixes) from words in the 
spelling list are printed on the standard output. If no files are named, 
words are collected from the standard input. 

spell ignores most troff( CT), tbl (CT), and eqn(C T) constructions. 

Under the -v option, all words not literally in the spelling list are 
printed, and plausible derivations from the words in die spelling list 
are indicated. 

Under the -b option, British spelling is checked. Besides preferring 
centre, colour, programme, speciality, travelled, etc., this option 
insists upon -ise in words like standardise. 

Under the -x option, every plausible stem is printed with = for each 
word. 

By default, spell (like der off (CT)) follows chains of included files (.so 
and .nx troffiCT) requests), unless the names of such included files 
begin with /usr/lib. Under the -1 option, spell will follow the chains of 
all included files. Under the -i option, spell will ignore all chains of 
included files. 

Under the +localJile option, words found in local Jile are removed 
from spell's output. LocalJile is the name of a user-provided file that 
contains a sorted list of words, one per line. With this option, the user 
can specify a set of words that are correct spellings (in addition to 
spell ’s own spelling list) for each job. 


March 15,1989 


SPELL-1 







SPELL(C) 


SPELL(C) 


The spelling list is based on many sources, and while more haphazard 
than an ordinary dictionary, it is also more effective with respect to 
proper names and popular technical words. Coverage of the special¬ 
ized vocabularies of biology, medicine, and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indi¬ 
cated below with their default settings (see FILES). Copies of all out¬ 
put are accumulated in the history file. The stop list filters out 
misspellings (e.g., thier=thy-y+ier) that would otherwise pass. 

Three routines help maintain and check the hash lists used by spell: 

hashmake Reads a list of words from the standard input and writes 
the corresponding nine-digit hash codes on the standard 
output. 

spellin n Reads n hash codes from the standard input and writes a 
compressed, or hashed spellingJist , such as 

lusrllib/spell/hlista or lusrllib/spell/hlistb , on the stan¬ 
dard output. Information about the hash coding is 
printed on standard error. 

hashcheck Reads a compressed, or hashed spelling Jist, such as 
/usrllib/spell/hlista or /usrtlibtspell/hlistb , and recreates 
the nine-digit hash codes for all the words in it, writing 
these codes on the standard output. 

Examples 


This example adds the words in newwords to the on-line dictionary 
{I usrl lib! spell! hlista): 

cd /usr/lib/spell 

cat newwords I ./hashmake I sort -u > newcodes 
cat hlista I ./hashcheck > hashcodes 
cat newcodes hashcodes I sort -u > newhash 
cat newhash I ./spellin ‘cat newhash I wc -F > hlist 

mv hlista hlista.00 
mv hlist hlista 

cd /usr/dict 

cat newwords words I sort -du > tempwords 
mv words words.00 
mv tempwords words 

Remember to remove all temporary files after you are sure everything 
works. 
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The following example removes words from the on-line dictionary. 
You should first make a copy of /usr/dict/words that does not have the 
words you want to remove. Make sure the file is sorted in alphabetical 
order. Then, follow these steps: 

cd /usr/lib/spell 

cat /usr/dict/words I ./hashmake > hashcodes 

cat hashcodes I ./spellin ‘cat hashcodes I wc -F > newhlist 

mv hlista hlista.00 
mv newhlist hlista 

Note that when you are manipulating large text, hash and hash code 
files, you should use cat (C) to open the files, since they may be 
extremely large. 

Files 


D_SPELL=/usr/lib/spell/hlist[ab] hashed spelling lists, American & 

British 

S_SPELL=/usr/lib/spell/hstop hashed stop list 

H_SPELL=/usr/lib/spell/spellhist history file 

/usr/lib/spell/spellprog program 

See Also 


deroff(CT), eqn(CT), sed(C), sort(C), tbl(CT), tee(C), troffiCT) 

Notes 


The spelling list coverage is uneven; new installations will probably 
wish to monitor the output for several months to gather local addi¬ 
tions; typically, these are kept in a separate local file that is added to 
the hashed spelling Jist via spellin. 

By default, logging of errors to /usr/lib/spell/spellhist is turned off. 

D_SPELL and S_SPELL can be overridden by placing alternate 
definitions in your environment. 

Standards Conformance 


hashcheck, hashmake and spellin are conformant with: 
AT&T SVID Issue 2, Select Code 307-127. 

spell is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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spline _ 

interpolates smooth curve 

Syntax 

spline [ option ]... 

Description 


spline takes pairs of numbers from the standard input as abscissas and 
ordinates of a function. It produces a similar set, which is approxi¬ 
mately equally spaced and includes the input set, on the standard out¬ 
put. The cubic spline output has two continuous derivatives, and 
enough points to look smooth when plotted. 

The following options are recognized, each as a separate argument. 

-a Supplies abscissas automatically (they are missing from the 
input); spacing is given by the next argument, or is assumed to 
be 1 if next argument is not a number. 

-k The constant k used in the boundary value computation 

yo =k y l *•••»?» =k yn -1 

is set by the next argument. By default k = 0. 

-n Spaces output points so that approximately n intervals occur 
between the lower and upper x limits. (Default n = 100.) 

-p Makes output periodic, i.e. matches derivatives at ends. First 
and last input values should normally agree. 

-x Next 1 (or 2) arguments are lower (and upper) x limits. Nor¬ 
mally these limits are calculated from the data. Automatic 
abscissas start at lower limit (default 0). 

Diagnostics 


When data is not strictly monotone in x, spline reproduces the input 
without interpolating extra points. 

Notes 


A limit of 1000 input points is silently enforced. 
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split _ 

splits a file into pieces 

Syntax 

split [ -n ] [ file [ name ] ] 

Description 


split reads file and writes it in as many n -line pieces as necessary 
(default 1000), onto a set of output files. The name of the first output 
file is name with aa appended, and so on lexicographically. If no out¬ 
put name is given, x is default. 

If no input file is given, or if a dash (-) is given instead, the standard 
input file is used. 

See Also 


bfs(C), csplit(C) 

Standards Conformance 


split is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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strings _ 

find the printable strings in an object file 

Syntax 

strings [-] [-o] [ -number ] filename ... 

Description 


strings looks for ASCII strings in a binary file. A string is any 
sequence of four or more printing characters ending with a newline or 
a null character. Unless the - flag is given, strings only looks in the 
initialized data space of object files. If the -o flag is given, then each 
string is preceded by its decimal offset in the file. If die -number flag 
is given then number is used as the minimum string length rather than 

strings is useful for identifying random object files and many other 
things. 

See Also 


hd(C), od(C) 

Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 
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stty_ 

sets the options for a terminal 

Syntax 

stty [ -a ] [ -g ] [ options ] 

Description 


stty sets certain terminal I/O options for the device that is the current 
standard input; without arguments, it reports the settings of certain 
options. With the -a option, stty reports all of the option settings. The 
-g option causes stty to output the current stty settings of the terminal 
as a list of twelve hexadecimal numbers seperated by colons. This 
output may be used as a command line argument to stty to restore 
these settings later on. It is a more compact form than stty -a. For 
example, the following shell script uses stty -g to store the current stty 
settings, then turns off character echo while reading a line of input. 
The stored stty values are then restored to the terminal: 


echo "Enter your secret code: \c" 

old='stty -g' 

stty -echo intr "a 

read code 

stty $old 

The various modes are discussed in several groups that follow. 
Detailed information about the modes listed in the first four groups 
may be found in termio( M). options in the last group are implemented 
using options in the previous groups. Refer to vidi(C) for hardware 
specific information that describes control modes for the video moni¬ 
tor and other display devices. 


Common Control Modes 


parenb (-parenb) 

Enables (disables) parity generation and detection. 


parodd (-parodd) 

Selects odd (even) parity. 


cs5 cs6 cs7 cs8 

Selects character size (see termio (M)). 
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0 Hangs up phone line immediately. 

50 75 110 134 150 200 300 600 
1200 1800 2400 4800 9600 19200 

Sets terminal baud rate to the number given, if possible. 

ispeed 50 75110134150 
1200 1800 3400 4800 9600 19200 

sets terminal output baud rate separately. 

ospeed 50 75 110 134 150 
1200 1800 3400 4800 9600 19200 

sets terminal input baud rate separately. 

hupcl (-hupcl) 

Hangs up (does not hang up) phone connection on last close. 

hup (-hup) 

Same as hupcl (-hupcl). 
cstopb (-cstopb) 

Uses two(one) stop bits per character, 
cread (-cread) 

Enables (disables) the receiver, 
clocal (-clocal) 

Assumes a line without (with) modem control, 
ctsflow (-ctsflow) 

Enables CTS protocol for a modem or non-modem line, 
rtsflow (-rtsflow) 

Enables RTS signaling for a modem or non-modem line. 


Input Modes 

ignbrk (-ignbrk) 

Ignores (does not ignore) break on input, 
brkint (-brkint) 

Signals (does not signal) INTERRUPT on break. 

ignpar (-ignpar) 

Ignores (does not ignore) parity errors. 

parmrk (-parmrk) 

Marks (does not mark) parity errors (see fty(M)). 
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inpck (-inpck) 

Enables (disables) input parity checking, 
istrip (-istrip) 

Strips (does not strip) input characters to 7 bits. 

inlcr (-inlcr) 

Maps (does not map) NL to CR on input, 
igncr (-igncr) 

Ignores (does not ignore) CR on input, 
icml (-icrnl) 

Maps (does not map) CR to NL on input, 
iuclc (-iuclc) 

Maps (does not map) uppercase alphabetics to lowercase on input, 
ixon (-ixon) 

Enables (disables) START/STOP output control. Output is stopped 
by sending an ASCII DC3 and started by sending an ASCII DC1. 

ixany (-ixany) 

Allows any character (only DC1) to restart output, 
ixoff (-ixoff) 

Requests that the system send (not send) START/STOP characters 
when the input queue is nearly empty/full. 


Output Modes 
opost (-opost) 

Post-processes output (does not post-process output; ignores all 
other output modes). 

olcuc (-olcuc) 

Maps (does not map) lowercase alphabetics to uppercase on out¬ 
put. 

onlcr (-onlcr) 

Maps (does not map) NL to CR-NL on output. 

ocrnl (-ocrnl) 

Maps (does not map) CR to NL on output, 
onocr (-onocr) 

Does not (does) output CRs at column zero. 

onlret (-onlret) 

On the terminal NL performs (does not perform) the CR function. 
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ofill (-ofill) 

Uses fill characters (use timing) for delays, 
ofdel (-ofdel) 

Fill characters are DELETES (NULs). 
crO crl cr2 cr3 

Selects style of delay for RETURNS (see tty(M)). 

nIO nil 

Selects style of delay for LINEFEEDS (see «y(M)). 

tabO tabl tab2 tab3 

Selects style of delay for horizontal TABs (see tty (M)). 

bsO bsl 

Selects style of delay for BACKSPACES (see tfy(M)). 

fro in 

Selects style of delay for FORMFEEDS (see wy(M)). 

vtO vtl 

Selects style of delay for Vertical TABs (see ny(M)). 


Local Modes 
isig (-isig) 

Enables (disables) the checking of characters against the special 
control characters INTERRUPT and QUIT. 

icanon (-icanon) 

Enables (disables) canonical input (ERASE and KILL processing), 
xcase (-xcase) 

Canonical (unprocessed) upper/lowercase presentation, 
echo (-echo) 

Echoes back (does not echo back) every character typed, 
echoe (-echoe) 

Echoes (does not echo) ERASE character as a SPACEBAR string. 
Note: this mode will erase the ERASE character on many CRT ter¬ 
minals; however, it does not keep track of column position and, as 
a result, may be confusing on escaped characters, TABs, and 
BACKSPACES. 

echok (-echok) 

Echoes (does not echo) NL after KILL character. 
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lfkc (-lfkc) 

The same as echok (-echok); obsolete. 

echonl (-echonl) 

Echoes (does not echo) NL. 

noflsh (-noflsh) 

Disables (enables) flush after INTERRUPT or QUIT. 
iexten(-iexten) 

Enables extended implementation (implementation-defined) func¬ 
tion. 

tostop(-tostop) 

Disables/enables background process group to write to controlling 
terminal only if job control is supported. 


Control Assignments 
control-character C 

control-character C Sets control-character to C, where control- 
character is erase, kill, interrupt, quit, eof, eol, switch, or susp If C 
is preceded by a caret Q (escaped from the shell), then the value 
used is the corresponding CTRL character (e.g., “~D” is a CTRL-D 
); is interpreted as DELETE and is interpreted as 

undefined. 

min /, time i (0<kl27) 

When -icanon is set, and one character has been received, read 
requests are not satisfied until at least min characters have been 
received or the timeout value time has expired and one character 
has been received. See tty( C). 

line i 

Sets the line discipline to i (0 < i < 127 ). There are currently no 
line disciplines implemented. 


Combination Modes 

evenp or parity 

Enables parenb and cs7. 

oddp 

Enables parenb, cs7, and parodd. 

-parity, -evenp, or -oddp 

Disables parenb, and sets cs8. 
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raw (-raw or cooked) 

Enables (disables) raw input and output (no ERASE, KILL, INTER¬ 
RUPT, QUIT, EOT, or output post-processing). 

nl (-nl) 

Unsets (sets) icrnl, onlcr. In addition -nl unsets inlcr, igncr, 
ocrnl, and onlret. 

lease (-lease) 

Sets (unsets) xcase, iuclc, and olcuc. 

LCASE (-LCASE) 

Same as lease (-lease). 

tabs (-tabs or tab3) 

Preserves (expands to spaces) tabs when printing. 

ek Resets ERASE and KILL characters back to normal CTRL-H and 
CTRL-U. 

sane 

Resets all modes to some reasonable values. Useful when a 
terminal’s settings have been hopelessly scrambled. 

term 

Sets all modes suitable for the terminal type, TERM, where TERM 
is one of tty33, tty37, vt05, tn300, ti700, or tek. 

See Also 


console(M), ioctl(S), vidi(C), tty(M), termio(M), termios(M) 

Notes 


Many combinations of options make no sense, but no checking is per- 
formed. 

Standards Conformance 


stty is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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SU_ 

makes the user a super-user or another user 

Syntax 

su [ - ] [ name [ arg — ] ] 

Description 

su allows authorized users to become another user without logging 
off. The default user name is root (i.e., super-user). 

su cannot be used to simply assume the login of another user in this 
implementation of UNIX. Instead, su can be used under four cir¬ 
cumstances: 

• The super-user can “su” to any account. 

• An administrative user with the su authorization can “su” to 
the super-user account. 

• A user can “su” to their own account (silly, but possible). 

• A system daemon can “su” to an account. 

To use su, the appropriate password must be supplied (unless you are 
already a super-user). If the password is correct, su will execute a 
new shell with the effective user ID set to that of the specified user. 
(The LUID is not changed.) The new shell will be the optional pro¬ 
gram named in the shell field of the specified user’s password file 
(/bin/sh if none is specified (see sh(C)). To restore normal user ID 
privileges, press EOF (Ctrl-D) to the new shell. 

Any additional arguments given on the command line are passed to 
the program invoked as the shell. When using programs like sh(C), an 
arg of the form -c string executes string via the shell and an arg of -r 
gives the user a restricted shell. 

The following statements are true only if the optional program named 
in the shell field of the specified user’s password file entry is like 
sh(C). If the first argument to su is a -, the environment is changed to 
what would be expected if the user actually logged in as the specified 
user. This is done by invoking the program used as the shell with an 
argO value whose first character is -, thus causing first the system’s 
profile (/etc/profile) and then the specified user’s profile (.profile in 
the new HOME directory) to be executed. Otherwise, the environ¬ 
ment is passed along with the possible exception of $PATH, which is 
set to /bin:/etc:/usr/bin for root. Note that if the optional program 
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used as the shell is /bin/sh, the user’s .profile can check argO for -sh 
or -su to determine if it was invoked by login( M) or su( C), respec¬ 
tively. If the user’s program is other than /bin/sh, then .profile is 
invoked with an argO of ■program by both login( M) and su(C). 

The file /etc/default/su can be used to control several aspects of how 
su is used. Several entries can be placed in /etc/default/su: 

SULOG Name of log file to record all attempts to use su. Usually 
/usr/adm/sulog. If not set, no logfile is kept. (See example 
below.) 

PATH The PATH environment variable to set for non-root users. 

If not set, it defaults to “:/bin:/usr/bin.” The current 
PATH environment variable is ignored. 

SUPATH When invoked by root, the path is set by default to 
“/bin:/usr/bin:/etc”, unless this variable is defined.. The 
current PATH is ignored. 

CONSOLE Attempts to use su are logged to the named device, 
independently of SULOG. 

For example, if you want to log all attempts by users to become root, 
create the file /etc/default/su. In this file, place a string similar to: 
SULOG=/usr/adm/sulog This causes all attempts by any user to switch 
user IDs to be recorded in the file /usr/adm/sulog. This filename is 
arbitrary. The su logfile records the original user, the UID of the su 
attempt, and the time of the attempt. If the attempt is successful, a 
plus sign (+) is placed on the line describing the attempt. A minus 
sign (-) indicates an unsuccessful attempt. 

Examples 


To become user bin while retaining your previously exported environ¬ 
ment, enter: 

su bin 

To become user bin but change the environment to what would be 
expected if bin had originally logged in, enter: 

su - bin 

To execute command with the temporary environment and permissions 
of user bin, enter: 

su - bin -c “command args” 
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/etc/passwd 

The system password file 

/etc/default/su 

Optional file containing control options 

/etc/profile 

The system profile 

$HOME/.profile 

The user profile 

See Also 



env(C), environ(M), login(M), passwd(F), profile(M), sh(C), auths(C) 

Standards Conformance 


su is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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sum _ 

calculates checksum and counts blocks in a file 

Syntax 

sum [ -r ] file 

Description 


sum calculates and prints a 16-bit checksum for the named file, and 
also prints the number of 512-byte blocks in the file. It is typically 
used to look for bad spots, or to validate a file communicated over a 
transmission line. The option -r causes an alternate algorithm to be 
used in computing the checksum. 

See Also 


cmchk(C), machine(HW), wc(C) 

Diagnostics 


“Read error” is indistinguishable from end-of-file on most devices; 
check the block count. 

Standards Conformance 


sum is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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swconfig _ 

produces a list of the software modifications to the 
system 

Syntax 


swconfig [-a] [-p] 

Description 

swconfig displays the modifications to the system software since its 
initialization, in much the same way that hwconfig tells the user what 
hardware is installed on the system. The program can tell the user 
what sets have been installed or removed from the system, as well as 
what release and what parts of the packages were installed at that 
time. 

Options 


Additional flags let the user ask to see all of the description of each 
installation on the system. 

The default behavior is simple so that the information is displayed 
quickly. Additional flags can be used to perform more complex mani¬ 
pulations. Updates are recognized and noted as such. The release 
number is displayed in all cases. 

Without options, swconfig generates a display similar to the following 
example: 


Set 


Release Notes 


Operating System 2.3.1a 
International XENIX O.S. Supplem 2.0.0e 
Development System 2.3.0b 


partially removed 
partially installed 
removed 


-a The -a flag lists all the information contained in 
Aisr/lib/custom/history, but sorted by date. It groups pro¬ 
ducts that were installed at the same time, but displays 
entries in reverse chronological order. 

-p The flag -p is used to display package information in addi¬ 
tion to the default information. A list of all the packages in 
a set is stored and their installed status tracked by the 
sequence of information in /usr/lib/custom/history. 
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Here is a sample output using the -a option: 

Set: Operating System (prd = xos) 

Fri Mar 17 07:51:02 PST 1989 

removed successful Release 2.3.1a Type: 386GT 

Packages: HELP MOUSE 

Fri Mar 17 10:43:09 PST 1989 

removed successful Release 2.3.1a Type: 386GT 

Packages: VSH 

Set: International XENIX O.S. Supplement (prd = sup.os) 

Fri Dec 16 10:32:53 PST 1988 

installed successful Release 2.0.0e Type: n286 

Packages: RTSUP BASE SYSADM FILE 

Fri Dec 16 11:03:37 PST 1988 

installed successful Release 2.0.0e Type: n286 

Packages: MAPFILE 


Here is a sample output generated by the -p option: 


Set 

Release 

Notes 

Packages 

Operating System 

2.3.1a 

removed 

HELP MOUSE 

Operating System 

2.3.1a 

removed 

VSH 

International XENIX O.S. Supplem 

2.0.Oe 

installed 

RTSUP BASE 
SYSADM FILE 

International XENIX O.S. Supplem 

2.0.Oe 

installed 

MAPFILE 

Develoment System 

2.3.0b 

removed 

ALL 


See Also 


custom(ADM) 
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tabs 


set tabs on a terminal 


Syntax 

tabs [tabspec] [-Ttype] [+mn] 

Description 

The tabs command sets the tab stops on the user’s terminal according 

to the tab specification tabspec, after clearing any previous settings. 

The user’s terminal must have remotely-settable hardware tabs. 

tabspec Four types of tab specification are accepted for tabspec. 

They are described below: canned (-code), repetitive (-«), 
arbitrary (nl,n2,...), and file (--file). If no tabspec is given, 
the default value is -8, i.e., “standard” UNIX tabs. The 
lowest column number is 1. Note that for tabs, column 1 
always refers to the leftmost column on a terminal, even one 
whose column markers begin at 0, e.g., the DASI 300, DASI 
300s, and DASI450. 

-code Use one of the codes listed below to select a canned set of 
tabs. The legal codes and their meanings are as follows: 

-a 1,10,16,36,72 

Assembler, IBM S/370, first format 
-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 
-c 1,8,12,16,20,55 

COBOL, normal format 
-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). 
Using this code, the first typed character 
corresponds to card column 7, one space gets you 
to column 8, and a tab reaches column 12. Files 
using this tab setup should include a format 
specification as follows [see fspec(F)]: 

<:t-c2 m6 s66 d:> 

-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), 
with more tabs than -c2. This is the recommended 
format for COBOL. The appropriate format 
specification is [see fspec( F)]: 

<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 

FORTRAN 
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-p 1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 

PL/I 

-s 1,10,55 

SNOBOL 
-u 1,12,20,44 

UNTVAC 1100 Assembler 

" n A repetitive specification requests tabs at columns 1+az, 
1+2 *n, etc. Of particular importance is the value 8: this 
represents the “standard” UNIX tab setting, and is the most 
likely tab setting to be found at a terminal. Another special 
case is the value 0, implying no tabs at all. 

nl ,n2 ,... The arbitrary format permits the user to type any chosen set 
of numbers, separated by commas, in ascending order. Up to 
40 numbers are allowed. If any number (except the first one) 
is preceded by a plus sign, it is taken as an increment to be 
added to the previous value. Thus, the formats 1,10,20,30, 
and 1,10,+10,+10 are considered identical. 

v file If the name of a file is given, tabs reads the first line of the 

file, searching for a format specification [see fspec(F)]. If it 
finds one there, it sets the tab stops according to it, otherwise 
it sets them as -8. This type of specification may be used to 
make sure that a tabbed file is printed with correct tab set¬ 
tings, and would be used with the pr(C) command: 
tabs ~ file; pr file 

Any of the following also may be used; if a given flag occurs more 

than once, the last value given takes effect: 

"T type tabs usually needs to know the type of terminal in order to 

set tabs and always needs to know the type to set margins. 
type is a name listed in term{ M). If no -T flag is supplied, 
tabs uses the value of the environment variable TERM. If 
TERM is not defined in the environment [see environ (M)], 
tabs tries a sequence that will work for many terminals. 

+mn The margin argument may be used for some terminals. It 
causes all tabs to be moved over n columns by making 
column n+1 the left margin. If +m is given without a value 
of n , the value assumed is 10. For a TermiNet, the first value 
in the tab list should be 1, or the margin will move even 
further to the right. The normal (leftmost) margin on most 
terminals is obtained by +m0. The margin for most termi¬ 
nals is reset only when the +m flag is given explicitly. 

Tab and margin setting is performed via the standard output. 
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tabs -a example using -code (canned specification) to set tabs 

to the settings required by the IBM assembler: 
columns 1,10,16,36,72. 

tabs -8 example of using -n (repetitive specification), where n 

is 8, causes tabs to be set every eighth position: 
1+(1*8), l+(2*8),... which evaluate to columns 9, 17, 


tabs 1,8,36 example of using nl,n2,... ( arbitrary specification) to 
set tabs at columns 1,8, and 36. 

tabs -$HOME/fspec.list/att4425 

example of using —file (file specification) to indicate 
that tabs should be set according to the first line of 
$HOME/fspec.list/att4425 [see fspec( F)]. 


Diagnostics 


illegal tabs 
illegal increment 

unknown tab code 
can't open 
file indirection 

when arbitrary tabs are ordered incopectly 

when a zero or missing increment is found in an 

arbitrary specification 

when a canned code cannot be found 

if —file option used and file can’t be opened 

if -file option used and the specification in that 

file points to yet another file. Indirection of this 

form is not permitted 

See Also 


newform(C), pr(C), tput(C), fspec(F), terminfo(F), environ(M), 
term(M) 

Notes 



There is no consistency among different terminals regarding ways of 
clearing tabs and setting the left margin. 

tabs clears only 20 tabs (on terminals requiring a long sequence), but 
is willing to set 64. 

The tabspec used with the tabs command is different from the one 
used with the newform(C) command. For example, tabs -8 sets every 
eighth position; whereas newform -i-8 indicates that tabs are set 
every eighth position. 
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tabs is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tail_ 

displays the last part of a file 

Syntax 

tail [ ±[number][lbc] [ -f ] ] [ file ] 

Description 

tail copies the named file to the standard output beginning at a desig¬ 
nated place. If no file is named, the standard input is used. 

Copying begins at distance +number from the beginning, or -number 
from the end of the input (if number is null, the value 10 is assumed). 
Number is counted in units of lines, blocks, or characters, according to 
the appended option 1, b, or c. When no units are specified, counting 
is by lines. 

With the -f (“follow”) option, if the input file is not a pipe, the pro¬ 
gram will not terminate after the line of the input file has been copied, 
but will enter an endless loop, wherein it sleeps for a second and then 
attempts to read and copy further records from the input file. Thus it 
may be used to monitor the growth of a file that is being written by 
some other process. For example, the command: 

tail -f file 

will print the last ten lines of file , followed by any lines that are 
appended to file between the time tail is initiated and killed. 

See Also 


dd(C) 

Notes 


Tails relative to the end of the file are kept in a buffer, and thus are 
limited to approximately 300 lines. Unpredictable results can occur if 
character special files are “tailed”. 

Standards Conformance 


tail is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tape, mcart 

magnetic tape maintenance program 

Syntax 

tape [ -c ] [ -f ] [ -a arg ] command [ device ] 
mcart command [ device ] 

Description 


tape sends commands to and receives status from the tape subsystem. 
tape can communicate with QIC-02 cartridge tape drives, SCSI tape 
drives, and QIC-40, QIC-80 and Irwin mini-cartridge tape drives. 
(The mcart program is automatically invoked by tape when options 
specific to the Irwin driver are used.) 

tape reads /etc/default/tape to find the default device name for send¬ 
ing commands and receiving status. For example, the following line 
in /etc/default/tape will cause tape to communicate with the QIC-02 
cartridge tape device: 

device = /dev/xctO 

If a device name is specified on the command line, it overrides the 
default device, tape queries the device to determine its device type. 
If the device does not respond to the query, for example if the car¬ 
tridge tape driver is from an earlier release, tape will print a warning 
message and assume the device is a QIC-02 cartridge tape. 

You can explicitly specify the type of the device by using the device 
type flags, as follows: 

-c QIC-02 cartridge tape 

-s SCSI tape 

-f QIC-40 mini-cartridge tape 

-8 QIC-80 mini-cartridge tape 

-i Irwin mini-cartridge tape 

The -a flag allows you to pass an argument to commands that can use 
them. The only command that currently can take an argument is the 
format command, and a format argument is only valid with QIC-40 
and QIC-80 tape drives. 
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The following commands can be used with the various tape drivers 
supported under UNIX. The letters following each description indi¬ 
cate which drivers support each command: 

A All drivers 

C QIC-02 cartridge tape driver 

S SCSI tape driver 

F QIC-40 and QIC-80 mini-cartridge tape drivers 

I Irwin mini-cartridge tape driver 


amount 

Report amount of data in current or last transfer. (C,S,F) 
erase 

Erase and retension the tape cartridge. (C,S,F) 
reset 

Reset tape controller and tape drive. Clears error conditions and 
returns tape subsystem to power-up state. (C,S,F) 

reten 

Retension tape cartridge. Should be used periodically to remedy 
slack tape problems. Tape slack can cause an unusually large 
number of tape errors. (A) 

rewind 

Rewind to beginning of tape. (A) 
status 

The status output looks like this: 

status: status message 

soft errors: n 
underruns: m 

status message is a report of the current status of the drive; “no 
cartridge,” “write protected,” or “beginning of tape” are typical 
status messages. 

soft errors is the number of recoverable errors that occurred during 
the last tape operation. A recoverable error is one which is 
correctable by the drive or controller. An example of a non- 
recoverable “hard” error is an attempt to write to a write-protected 
cartridge. Note that if the number of soft errors greatly exceeds 
the manufacturer’s specifications, the drive may require service or 
replacement. 
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underruns is the number of times the tape drive had to stop and 
restart due to tape buffer underflows. Underruns do not indicate an 
error, but that the data transfer did not occur at the drive’s max¬ 
imum data transfer rate. The number of underruns can be affected 
by system load. (C,S,F) 

format 

Format the tape cartridge. Tapes must be formatted before they 
can be used. This command takes approximately one minute per 
megabyte of tape capacity. Note that on Irwin mini-cartridge tape 
drives, blank tapes must be servo-written with the servo command 
before they can be formatted. If an argument is provided with the 
-a flag, the number of tracks specified by the argument will be for¬ 
matted. Only even numbers less than or equal to the number of 
tracks on the tape are allowed. (See tape(HW) for more informa¬ 
tion.) If no argument is given, the entire tape will be formatted. 
(F,I) 

getbb 

Prints a list of bad tape blocks detected during the last tape opera¬ 
tion. This listing can be saved in a file for use by the putbb com¬ 
mand. (F) 

map 

Prints out a map of the bad blocks on the tape. The format is a 
series of lines of the format: 

track n : -X-. . . 

Each represents a good block on the track; an ’X’ represents a 
block marked as bad. (F,I) 

putbb 

Reads a list of bad tape blocks from the standard input and adds 
them to the bad block table on the tape. The format expected by 
putbb is the same as generated by the getbb command. (F) 

rfm 

Wind tape forward to the next file mark. (C,S) 

wfm 

Write a file mark at the current tape position. (C,S) 
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The following commands are all specific to Irwin drives. 

drive 

displays information about the Irwin driver and the tape drive. An 
example display is: 


Special file: /dev/rmcO 
Driver version: 1.0.6a 
Drive type: 285XL 
Drive firmware: AO 
Controller type: SYSFDC 
Unit select (0-3): 3 

Special file is the name of the special file used to access the driver. 

Driver version is the version of the driver linked with the kernel. 

Drive type is an “equivalent” tape drive model number as deter¬ 
mined by the MC driver. Since the exact model number of the tape 
drive depends on the drive’s form factor and whether the drive is 
mounted in its own cabinet, the equivalent model number may not 
be the exact model of the installed tape drive. The following is a 
list of equivalent drives: 

110: 110,310,410 

120[XL]: 120,220,320,420,720,2020 
125: 125,225,325,425,725 

145[XL]: 145,245,345,445,745,2040 
165: 165,265,465,765 

285XL: 285,485,785,2080 
287XL: 287,487,787,2120 

The brackets in the 120[XL] and 145 [XL] mean the letters “XL” 
may or may not be present. When the letters “XL” appear, the 
drive is capable of servo writing extra long (i.e., 307.5 foot 
DC2120) tapes. 

Note: When this field displays “125/145,” either a 125 drive or an 
early model 145 drive with a DC 1000 is present, the driver can’t 
distinguish between the two. A 125 drive will only accept a 
DC1000 cartridge (a DC2000 or DC2120 will not fit). A 145 drive 
will accommodate DC1000, DC2000, or DC2120 cartridges. 

Drive firmware is the firmware part number and revision level. 
This line is present only for drives which report this information. 
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Controller type: is a mnemonic for the floppy controller to which 
the tape drive is attached: 


Mnemonic 

Description 

SYSFDC 

ALTFDC 

4100MC 

4100MCB 

4100 

4100B 

System floppy controller 

Alternate floppy controller 

Irwin 4100MC Micro Channel controller 
Second 4100MC Micro Channel controller 
Irwin 4100 PC Bus controller 

Second 4100 PC Bus controller 


Unit select (0-3) gives the controller’s unit select, in the range 0 
through 3. The unit select selects the drive. 

servo 

Prepares a blank tape for formatting by writing servo information 
on each track. This command must be used on blank mini¬ 
cartridge tapes before they can be used in an Irwin mini-cartridge 
drive. If the tape has been previously servo-written, it must be 
bulk-erased with a commercial tape eraser before it can be servo- 
written again. Normally, a tape should only be servo-written once 
in its lifetime, although it can be formatted with the format com¬ 
mand many times. 

info 

displays Irwin cartridge information. For example: 

Cartridge state: Formatted 
Cartridge format: 145 

Write protect slider position: RECORD 

Cartridge state is the current state of the cartridge’s format. 

Cartridge format indicates the format on the cartridge’s tape. The 
format is given in a code which is the same as the drive model on 
which the cartridge was originally formatted (see drive and 
tape( HW) for details). When the cartridge is blank, the code has 
the format which would be applied by the format command. 

Write protect slider position is RECORD or PROTECT. 

capacity 

cartridge capacity in 512-byte blocks. 

kapacity 

cartridge capacity in 1024-byte blocks. 

These two commands give the total usable data storage capacity of 
a formatted tape cartridge. Variations in cartridge capacity are due 
to differing numbers of bad blocks. 
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Files 


/dev/rStpO /dev/rctO 

/dev/nrStpO /dev/nrctO 

/dev/xStpO /dev/rct2 

/dev/rftO /dev/nrct2 

/dev/xftO /dev/xctO 


/dev/erctO /dev/rmcl 

/dev/xctO /dev/mcdaemon 

/dev/rctmini 

/dev/xctmini 

/dev/rmcO 


/etc/default/tape 


Include files: 


/usr/include/ sys/tape.h 
/usr/include/sys/ct.h 
/usr/include/sys/ft.h 
Aisr/include/sys/ir.h 


See Also 

backup!ADM), cpio(C), dd(C), restore(ADM), tape(HW), tar(C), 
" xbackup(ADM), xrestore(ADM) 


Notes 


See tape (HW) for a list of supported tape drives. 

The amount and reset commands can be used while the tape is busy 
with other operations. All other commands wait until the currently 
executing command has been completed before proceeding. 

When you are using the non-rewinding tape device or the tape com¬ 
mands rfm and wfm, the tape drive light remains on after the com¬ 
mand has been completed, indicating that more operations may be 
performed on the tape. The tape rewind command may be used to 
clear this condition. 

For more information on devicefiles, (listed above), see the tape( HW) 
manual page. 

If you use the status command while the tape drive is busy, no mes¬ 
sage is displayed until the drive is free. 

The amount command doesn’t work with QIC-40 mini-cartridge tape 
devices. 
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tapecntl _ 

AT&T tape control for QIC-24/QIC-02 tape device 

Syntax 

tapecntl [ -etrw ] [ -p arg ] 

Description 


tapecntl will send the optioned commands to the tape device driver 
sub-device /dev/rmt/cOsO for all commands except “position,” which 
will use sub-device /dev/rmt/cOsOn using the ioctl command function. 
Sub-device /dev/rmt/cOsO provides a rewind on close capability, 
while /dev/rmt/cOsOn allows for closing of the device without rewind. 
Error messages will be written to standard error. 

-e erase tape 

-t retension tape 

-r reset tape device 

-w rewind tape 

-pM position tape to “end of file” mark - n 

Erasing the tape causes the erase bar to be activated while moving the 
tape from end to end, causing all data tracks to be erased in a single 
pass over the tape. 

Retensioning the tape causes the tape to be moved from end to end, 
thereby repacking the tape with the proper tension across its length. 

Reset of the tape device initializes the tape controller registers and 
positions the tape at the beginning of the tape mark (BOT). 

Rewinding the tape will move the tape to the BOT. 

Positioning the tape command requires an integer argument. Position¬ 
ing the tape will move the tape forward relative to its current position 
to the end of the specified file mark. The positioning option used with 
an argument of zero will be ignored. Illegal or out-of-range value 
arguments to the positioning command will leave the tape positioned 
at the end of the last valid file mark. 

Options may be used individually or strung together with selected 
options being executed sequentially from left to right in the command 
line. 
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Files 


Aisr/lib/tape/tapecntl 

/dev/rmt/cOsOn 

/dev/rmt/cOsO 


Notes 


Exit codes and their meanings are as follows: 

exit (1) device function could not initiate properly due to miscon- 
nected cables or poorly inserted tape cartridge. 

exit (2) device function failed to complete properly due to unre¬ 
coverable error condition, either in die command setup or 
due to mechanical failure. 

exit (3) device function failed due to the cartridge being write 
protected or to the lack of written data on die tape. 

exit (4) device /dev/rmt/cOsOn or /dev/rmt/cOsO failed to open 
properly due to already being opened or claimed by 
another process. 
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dumps magnetic tape to output file 

Syntax 

tapedump [-al-e] [-ol-h] [-btsiwu/n] tapedevice outputJile 

Description 

tapedump dumps the contents of magnetic tapes according to the 
options specified. Options include conversion from input format to 
user specified output format, specification of input and output block- 
size, and the ability to specify that the dump begin at a specific start 
block on the tape and proceed for a specified number of blocks. 

Options 


Option Value 


tape_device 

The input tape device. 

-a 

Convert from EBCDIC input to ASCII output. 

-e 

Convert from ASCII input to EBCDIC output. 

-0 

Display tape output in octal format. 

-h 

Display tape output in hexadecimal format. 

-b mm 

skips n input records before starting dump. 

-t mm 

Specify which tape file to begin dump from, 
where mm is the tape file sequence number. 

-s mm 

Specify tape block address from which to start dump. 

-n mm 

Specify dump of only num blocks. 

outputJile 

The output filename; standard output is the default. 


Examples 


This command reads a tape starting at block 400 and outputs the 
results in hexadecimal format into a user specified file called 
/tmp/hex.dump: 
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tapedump -MOO -h IdevIrctO Itmp/hexdump 

This command reads an EBCDIC tape and converts the standard out¬ 
put to ASCII: 

tapedump -a IdevIrctO 

See Also 


sysadmsh(ADM), dd(C), hd(C), od(C), tape(C) 

Notes 


The output file may be specified to be another tape device. 
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tar 

archives files 


Syntax 


tar [ key ] [ files ] 

Description 


tar saves and restores files to and from an archive medium, which is 
typically a storage device such as floppy disk or tape, or a regular file. 
Its actions are controlled by the key argument. The key is a string of 
characters containing at most one function letter and possibly one or 
more function modifiers. Valid function letters are c, t, x, and e. 
Other arguments to the command are files (or directory names) speci¬ 
fying which files are to be backed up or restored. In all cases, appear¬ 
ance of a directory name refers to the files and (recursively) subdirec¬ 
tories of that directory. The r and u option cannot be used with tape 
devices. 

The function portion of the key is specified by one of the following 
letters: 

r The named files are written to the end of an existing archive. 

x The named files are extracted from the archive. If a named 

file matches a directory whose contents had been written 
onto the archive, this directory is (recursively) extracted. 
The owner, modification time, and mode are restored (if pos¬ 
sible). If no files argument is given, the entire contents of 
the archive are extracted. Note that if several files with the 
same name are on the archive, the last one overwrites all 
earlier ones. 

t The names of the specified files are listed each time that 

they occur on the archive. If no files argument is given, all 
the names on the archive are listed. 

u The named files are added to the archive if they are not 

already there, or if they have been modified since last writ¬ 
ten on that archive. 

c Creates a new archive; writing begins at the beginning of the 

archive, instead of after the last file. 
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The following characters may be used in addition to the letter that 

selects the desired function: 

0,...,9999 

This modifier selects the drive on which the archive is 
mounted. The default is found in the file /etc/default/tar. 

v Normally, tar does its work silently. The v (verbose) option 

causes it to display the name of each file it treats, preceded 
by the function letter. With the t function, v gives more 
information about the archive entries than just the name. 

w Causes tar to display the action to be taken, followed by the 

name of the file, and then wait for the user’s confirmation. If 
a word beginning with y is given, the action is performed. 
Any other input means “no”. 

f Causes tar to use the next argument as the name of the 

archive instead of the default device listed in 
/etc/default/tar. If the name of the file is a dash (-), tar 
writes to the standard output or reads from the standard 
input, whichever is appropriate. Thus, tar can be used as the 
head or tail of a pipeline, tar can also be used to move 
hierarchies with the command: 

cd fromdir; tar cf - . I (cd todir; tar xf -) 

b Causes tar to use the next argument as the blocking factor 

for archive records. The default is 1, the maximum is 20. 
This option should only be used with raw magnetic tape 
archives (see f above). The block size is determined 
automatically when reading tapes (key letters x and t). 

F Causes tar to use the next argument as the name of a file 

from which succeeding arguments are taken. 

1 Tells tar to display an error message if it cannot resolve all 

of the links to the files being backed up. If 1 is not specified, 
no error messages are displayed. 

m Tells tar to not restore the modification times. The 

modification time of the file is the time of extraction. 

k Causes tar to use the next argument as the size of an archive 

volume in kilobytes. The minimum value allowed is 250. 
Very large files are split into “extents” across volumes. 
When restoring from a multivolume archive, tar only 
prompts for a new volume if a split file has been partially 
restored. To override the value of k in the default file, 
specify k as 0 on the command line. 
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e Prevents files from being split across volumes (tapes or 

floppy disks). If there is not enough room on the present 
volume for a given file, tar prompts for a new volume. This 
is only valid when the k option is also specified on the com¬ 
mand line. 

n Indicates the archive device is not a magnetic tape. The k 

option implies this. Listing and extracting the contents of an 
archive are sped because tar can seek over files it wishes to 
skip. Sizes are printed in kilobytes instead of tape blocks. 

p Indicates that files are extracted using their original permis¬ 

sions. It is possible that a non-super-user may be unable to 
extract files because of the permissions associated with the 
files or directories being extracted. 

A Suppresses absolute filenames. Any leading “/’’characters 

are removed from filenames. During extraction arguments 
given should match the relative (rather than the absolute) 
pathnames. With the c, r, u options the A options can be 
used to inhibit putting leading slashes in the archive 
headers. 

tar reads /etc/default/tar to obtain default values for the device, 
blocking factor, volume size, and the device type (tape or non-tape). 
If no numeric key is specified on the command, tar looks for a line in 
the default file beginning with the string archive =. Following this 
pattern are 4 blank separated strings indicating the values for the dev¬ 
ice, blocking factor, volume size and device type, in that order. A 
volume size of ‘O’ indicates infinite volume length. This entry should 
be modified to reflect the size of the tape volumes used. 

For example, the following is the default device entry from 
/etc/default/tar : 


archive=/dev/fd096dsl5 10 1200 n 

The n in the last field, means that this device is not a tape. Use y for 
tape devices. Any default value may be overridden on the command 
line. The numeric keys (0-7) select the line from the default value 
beginning with archive #=, where # is the numeric key. When the f 
key letter is specified on the command line, the entry n archivef- n is 
used. In this case, the default file entry must still contain 4 strings, but 
the first entry (specifying the device) is not significant. The default 
file /etc/default/tar need not exist if a device is specified on the com¬ 
mand line. 

Notes 


A critical consideration when creating a tar volume involves the use 
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of absolute or relative pathnames. Consider the following tar com¬ 
mand examples, as executed from the directory /u/target: 

tar cv /u/target/arrow 

tar cv arrow 

The first command creates a tar volume with the absolute pathname: 
/u/target/arrow. The second yields a tar volume with a relative path¬ 
name: ./arrow. (The ./ is implicit and shown here as an example, ./ 
should not be specified when retrieving the file from the archive.) 
When restored, the first example results in the file arrow being writ¬ 
ten to the directory /u/target (if it exists and you have write permis¬ 
sion) no matter what your working directory. The second example 
simple writes the file arrow to your present working directory. 

Absolute pathnames specify the location of a file in relation to the root 
directory (/); relative pathnames are relative to the current directory. 
This must be taken into account when making a tar tape or disk. 
Backup volumes use absolute pathnames so that they can be restored 
to the proper directory. Use relative pathnames when creating a tar 
volume where absolute pathnames are unnecessary. 

Examples 

If the name of a floppy disk device is /dev/fdl, then a tar format file 
can be created on this device by entering: 

assign /dev/fd 

tar cvfk /dev/fdl 360 files 

where files are the names of files you want archived and 360 is the 
capacity of the floppy disk in kilobytes. Note that arguments to key 
letters are given in the same order as the key letters themselves, thus 
the fk key letters have corresponding arguments /dev/fdl and 360. 
Note that if a file is a directory, the contents of the directory are recur¬ 
sively archived. To display a listing of the archive, enter: 

tar tvf /dev/fdl 

At some later time you will likely want to extract the files from the 
archive floppy. You can do this by entering: 

tar xvf /dev/fdl 

The above command extracts all files from the archive, using the exact 
same pathnames as used when the archive was created. Because of 
this behavior, it is normally best to save archive files with relative 
pathnames rather than absolute ones, since directory permissions may 
not let you read the files into the absolute directories specified. (See 
the A flag under Options.) 
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In the above examples, the v verbose option is used simply to confirm 
the reading or writing of archive files on the screen. Also, a normal file 
could be substituted for the floppy device /dev/fdl shown in the exam¬ 
ples. 

Files 


/etc/default/tar 

/tmp/tar* 


Default devices, blocking and 
volume sizes, device type 


Diagnostics 


Displays an error message about bad key characters and archive 
read/write errors. 

Displays an error message if not enough memory is available to hold 
the link tables. 

Notes 


There is no way to ask for the nth occurrence of a file. 

tar does not verify the selected media type. 

The u option can be slow. 

The limit on filename length is 100 characters. 

When archiving a directory that contains subdirectories, tar will only 
access those subdirectories that are within 17 levels of nesting. Sub¬ 
directories at higher levels will be ignored after tar displays an error 
message. 

When using tar with a raw device, specify the block size with the b 
option as a multiple of IK. For example, to use a 9K block size, enter: 

tar cvfb /dev/rfdO 18 file 

Do not enter: 

tar xfF - - 
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This would imply taking two things from the standard input at the 
same time. 

Use error-free floppy disks for best results with tar. 


Standards Conformance 


tar is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tee _ 

creates a tee in a pipe 

Syntax 

tee [ -i ] [ -a ] [ -u ] [ file ]... 

Description 


tee transcribes the standard input to the standard output and makes 
copies in the files . The -i option ignores interrupts; the -a option 
causes the output to be appended to the files rather than overwriting 
them. The -u option causes the output to be unbuffered. 

Examples 


The following example illustrates the creation of temporary files at 
each stage in a pipeline: 

grep ABC I tee ABC.grep I sort I tee ABC.sort I more 
This example shows how to tee output to the terminal screen: 
grep ABC I tee /dev/ttyxx I sort I uniq >final.file 

Standards Conformance 

tee is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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test _ 

tests conditions 

Syntax 


test expr 
[expr] 

Description 


test evaluates the expression expr , and if its value is true, returns a 
zero (true) exit status; otherwise, test returns a nonzero exit status if 
there are no arguments. The following primitives are used to con¬ 
struct expr: 

-r file True if file exists and is readable. 

-w file True if file exists and is writable. 

-xfile True if file exists and is executable. 

.f file True if file exists and is a regular file. 

-A file True if file exists and is a directory. 

-e file True if file exists and is a character special file. 

.b file True if file exists and is a block special file. 

, u file True if file exists and its set-user-ID bit is set. 

. g file True if file exists and its set-group-ID bit is set. 

.k file True if file exists and its sticky bit is set. 

. s file True if file exists and has a size greater than zero. 

-t [ fildes] True if the open file whose file descriptor number is 

fildes (1 by default) is associated with a terminal dev¬ 
ice. 

-z si True if the length of string si is zero. 

-n si True if the length of string si is nonzero. 
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II 

True if strings si and s2 are identical. 

si \=s2 

True if strings si and s2 are not identical. 

si 

True if si is not the null string. 

nl -eq ri2 

True if the integers nl and n2 are algebraically equal. 
Any of the comparisons -ne, -gt, -ge, -It, and -le may 
be used in place of -eq. 


These primaries may be combined with the following operators: 


; 

Unary negation operator 

-a 

Binary and operator 

-0 

Binary or operator (-a has higher precedence than 

-o) 

(expr) 

Parentheses for grouping 


Notice that all the operators and flags are separate arguments to test. 
Notice also, that parentheses are meaningful to the shell and, there¬ 
fore, must be escaped. 

See Also 

find(C), sh(C) 

Warning 

In the second form of the command (i.e., the one that uses [ ], rather 
than the word test), the square brackets must be delimited by blanks. 

Standards Conformance 


test is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tic_ 

terminfo compiler 

Syntax 

tic [-v [«] [-p permlist] ] file ... 

Description 


tic translates terminfo files from the source format into the compiled 
format. The results are placed in the directory /usr/lib/terminfo. 

The -v (verbose) option causes tic to output trace information showing 
its progress. If the optional digit n is appended, the level of verbosity 
can be increased. 

The -p option directs tic to create a permissions file permlist for use 
with fixperm( ADM). 

tic compiles all terminfo descriptions in the given files. When a use= 
field is discovered, tic first searches the current file and then the mas¬ 
ter file ./terminfo,src. 

If the environment variable TERMINFO is set, the results are placed 
there instead of/usr/lib/terminfo. 

Some limitations: the total size of a description cannot exceed 4096 
bytes; the name field cannot exceed 128 bytes. 

Files 


/usr/lib/terminfo/*/* -Compiled terminal capability database. 

See Also 

terminfo(M), terminfo(S), terminfo(F) 

Standards Conformance _ 

tic is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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time _ 

times a command 

Syntax 

time command 

Description 


The given command is executed; after it is complete, time prints the 
elapsed time during the command, the time spent in the system, and 
the time spent in execution of the command. Times are reported in 
seconds. 

The times are printed on the standard error. 

See Also 


times(S) 

Standards Conformance 


time is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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touch _ 

updates access and modification times of a file 

Syntax 

touch [ -amc ] [ mmddhhmmfyy] ] files 

Description 

touch causes the access and modification times of each argument to 
be updated. If no time is specified (see date{ C)) the current time is 
used. If a new file is created using touch, the modification and access 
times can be set to any time. However, the creation time is automati¬ 
cally set to the current time at the time of creation, and cannot be 
changed. The first mm refers to the month, dd refers to the day, hh 
refers to the hour, the second mm refers to the minute, and yy refers to 
the year. The -a and -m options cause touch to update only the access 
or modification times respectively (default is -am). The -c option 
silently prevents touch from creating the file if it did not previously 
exist. 

The return code from touch is the number of files for which the times 
could not be successfully modified (including files that did not exist 
and were not created). 

See Also 


date(C), utime(S) 

Standards Conformance 

touch is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tput _ 

queries the terminfo database 

Syntax 


tput [ -T type ] attribute 

Description 


The command tput uses the terminfo database to make the values of 
terminal-dependent attributes available to the jhell. tput outputs a 
string if the terminal attribute is of type string, or an integer if the 
attribute is of type integer. If the attribute is of type Boolean, tput 
simply sets the exit code (0 for true if the terminal has the capability, 
1 for false if it does not) and produces no output. 

The -T flag indicates the type of the terminal. Normally this option is 
unnecessary, as the default is taken from the environment variable 

TERM. 

attribute is the terminal capability name from the terminfo database. 

Examples 


tput clear 


Echo clear-screen sequence for the current ter¬ 
minal. 


tput cols Print the number of columns for the current ter¬ 

minal. 

tput -T450 cols Print the number of columns for the 450 termi¬ 

nal. 

bold=’tput smso’ 

offbold=’tput rmso’ Set the shell variables “bold” to begin stan¬ 
dout mode sequence and “offbold” to end 
standout mode sequence for the current termi¬ 
nal. This might be followed by a prompt, such 
as: 

echo "${bold)Name: ${ offbold )V" 
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tpiit he Set exit code to indicate if the current terminal 

is a hardcopy terminal. 


Files 


/usr/lib/terminfo/*/* -Compiled terminal capability database. 

See Also 


terminfo(M), terminfo(S), tic(C), stty(C) 

Notes 


If the attribute is of type boolean, a value of 0 is returned for TRUE 
and a value of 1 for FALSE. 

If the attribute is of type string or integer, a value of 0 is returned upon 
successful completion. Any other value returned indicates an error. 
For example, the specification of a bad attribute (any capability name 
that is not found in the terminfo database) produces an error. 

Standards Conformance 


tput is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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tr _ 

translates characters 

Syntax 

tr [ -cds ] [ stringl [ string2 ] ] 

Description 


tr copies the standard input to the standard output with substitution or 
deletion of selected characters. Input characters found in stringl are 
mapped into the corresponding characters of string2 . Any combina¬ 
tion of the options -cds may be used: 

-c Complements the set of characters in stringl with respect to 
the universe of characters whose ASCII codes are 001 
through 377 octal 

-d Deletes all input characters in stringl 

-s Squeezes all strings of repeated output characters that are in 
string2 to single characters 

The following abbreviation conventions may be used to introduce 
ranges of characters or repeated characters into the strings: 

[a-z] Stands for the string of characters whose ASCII codes run 
from character a to character z, inclusive. 

[a*«] Stands for n repetitions of a. If the first digit of n is 0, n is 
considered octal; otherwise, n is taken to be decimal. A 
zero or missing n is taken to be huge; this facility is useful 
for padding string2. 

The escape character \ may be used as in the shell to remove special 
meaning from any character in a string. In addition, \ followed by 1,2, 
or 3 octal digits, stands for the character whose ASCII code is given by 
those digits. 
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The following example creates a list of all the words in filel, one per 
line 'mfilel, where a word is taken to be a maximal string of alphabet - 
ics. The strings are quoted to protect the special characters from 
interpretation by the shell; 012 is the ASCII code for newline: 

tr -cs "[A-Z][a-z]" "[>012*]" <filel >file2 


See Also 


ed(C), sh(C), ascii(M) 

Notes 

Won’t handle ASCII NUL in stringl or string2; always deletes NUL 
from input. 

Standards Conformance 


tr is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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translate ___ 

translates files from one format to another 

Syntax 

translate option [ infile ] [ outfile ] 

Description 

translate translates files according to the options specified. Transla¬ 
tion is done according to the options defined below. 

format is assumed to be a file in the directory 
/usr/Iib/mapchan/translate if a full pathname is not provided. 

translate uses standard input and standard output unless otherwise 
specified via the optional filename arguments. 

Options 


-ea 

From EBCDIC to ASCII. 

-ae 

From ASCII to EBCDIC. 

-fe format 

From a user defined format to EBCDIC format. 

-faformat 

From a user defined format to ASCII format. 

-ef format 

From EBCDIC format to a user defined format. 

-atformat 

From ASCII format to a user defined format. 

-bm 

From binary/object code to mailable ASCII 
uuencode format. 

-mb 

From mailable ASCII uuencode format to 
original binary. 


Files 


/usr/lib/mapchan/translate/* 
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See Also 

uuencode(C), dd(C), mapchan(M), sysadmsh(ADM) 

Notes 


The -bm and -mb options are, for example, used to translate execut¬ 
able object code format to ASCII for transfer across communications 
networks. 

The syntax for the user defined format file is the same as the syntax 
for the mapping files for mapchan(M) and trchan. 

Use dd to convert character and file formats (especially tapes) to the 
format specified. Example: 

dd if=/dev/rmtO of=outfile ibs=800 cbs=80 conv=ascii,lease 

This command reads an EBCDIC tape, blocked ten 80-byte EBCDIC 
card images per record, into the ASCII file outfile. For more informa¬ 
tion on conversion options, refer to dd(C) in the User’s Reference. 
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true 

returns with a zero exit value 

Syntax 


true 

Description 


true does nothing except return with a zero exit value, false (C), true's 
counterpart, does nothing except return with a nonzero exit value. 
true is typically used in shell procedures such as: 

while true 
do 

command 

done 

See Also 


sh(C), false (C) 

Diagnostics 


true has exit status zero. 

Standards Conformance 


true is conforaiant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tset 

provide information to set terminal modes 


Syntax 

tset [ options ] [ type ] 

Description __. 

tset allows the user to set a terminal’s ERASE and KILL characters, 
and define the terminal’s type and capabilities by creating values for 
the TERM environment variable, tset initializes or resets the terminal 
with tput(C). If a type is given with the -s option, tset creates informa¬ 
tion for a terminal of the specified type. The type may be any type 
given in the terminfo database. If the type is not specified with the -s 
option, tset creates information for a terminal of the type defined by 
the value of the environment variable, TERM, unless the -h or -m 
option is given. If the TERM variable is defined, tset uses the 
terminfo database entry. If these options are used, tset searches the 
/etc/ttytype file for the terminal type corresponding to the current 
serial port; it then creates information for a terminal based on this 
type. If the serial port is not found in /etc/ttytype, the terminal type is 
set to unknown. 

tset displays the created information at the standard output. The infor¬ 
mation is in a form that can be used to set the current environment 
variables. The exact form depends on the login shell from which tset 
was invoked. The following examples illustrate how to use this infor¬ 
mation to change the variables. 

There are the following options: 


Sets the ERASE character to c on all terminals. The default setting 
is the BACKSPACE, or CTRL-H. 


Identical to the -e command except that it only operates on termi¬ 
nals that can BACKSPACE. 


-k[c] 


Sets the KILL character to c, defaulting to CTRL-U. 


- Prints the terminal type on the standard output. 
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-s Outputs the “setenv” commands [for c$/i(C)], or “export” and 
assignment commands [for sh(l)]. The type of commands are 
determined by the user’s login shell. 

-h Forces tset to search /etc/ttytype for information and to overlook 
the environment variable, TERM. 

-S Only outputs the strings to be placed in the environment variables, 
without the shell commands printed for -S. 

-r Prints the terminal type on the diagnostic output. 

-Q Suppresses the printing of the “Erase set to” and “Kill set to” mes¬ 
sages. 

-I Suppresses printing of the terminal initialization strings, e.g., 
spawns tput reset instead of tput init. 

-m [ ident ] [test baudrate ]: type 

Allows a user to specify how a given serial port is to be mapped to 
an actual terminal type. The option applies to any serial port in 
/etc/ttytype whose type is indeterminate (e.g., dialup , plugboard , 
etc.). Tlie type specifies the terminal type to be used, and ident 
identifies the name of the indeterminate type to be matched. If no 
ident is given, all indeterminate types are matched. The 
test baudrate defines a test to be performed on the serial port 
before the type is assigned. The baudrate must be as defined in 
stty{C). The test may be any combination of: >, =, <, @, and !. 
If the type begins with a question mark, the user is asked if he 
really wants that type. A null response means to use that type; oth¬ 
erwise, another type can be entered which will be used instead. 
The question mark must be escaped to prevent filename expansion 
by the shell. If more than one -m option is given, the first correct 
mapping prevails. 

tset is most useful when included in the .login [for csh{ C)] or .profile 

[for sh( C)] file executed automatically at login, with -m mapping used 

to specify the terminal type you most frequently dial in on. 

Examples 


tset gt42 

tset -mdialup\>300:adm3a -mdialup:dw2 -Qr -e# 

tset -m dial:ti733 -m plug:\?hp2621 -m unknown:\? -e -k'U 
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To use the information created by the -s option for the Bourne shell, 
(, sh ), repeat these commands: 

tset -s... >/tmp/tset$$ 

/tmp/tset$$ 

rm/tmp/tset$$ 

To use the information created for csh, use: 
set noglob 

set term=('tset -S ....') 
setenv TERM $term[l] 
unset term 
unset noglob 


Files 

/etc/ttytype Port name to terminal type map database 

/usr/lib/terminfo/* Terminal capability database 

See Also 

stty(C), termio(M), tput(C), tty(M), terminfo(F) 

Credit 

This utility was developed at the University of California at Berkeley 
and is used with permission. 
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tty 

gets the terminal’s name 
Syntax 
tty [ -s ] 

Description 


The tty command prints the pathname of the user’s terminal on the 
standard output. The -s option inhibits printing, allowing you to test 
just the exit code. 

Exit Codes 


0 if the standard input is a terminal, 1 otherwise. 

Diagnostics 


not a tty If the standard input is not a terminal and -s is not 

specified 

Standards Conformance 


tty is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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umask _ 

sets file-creation mode mask 

Syntax 


umask [ 000 ] 

Description 


The user file-creation mode mask is set to 000. The three octal digits 
refer to read/write/execute permissions for owner , group , and others , 
respectively. Only the low-order 9 bits of cmask and the file mode 
creation mask are used. The value of each specified digit is “sub¬ 
tracted” from the corresponding “digit” specified by the system for 
the creation of any file (see umask(S) or creat( S)). This is actually a 
binary masking operation, and thus the name “umask”. In general, 
binary ones remove a given permission, and zeros have no effect at 
all. For example, umask 022 removes group and others write permis¬ 
sion (files normally created with mode 111 become mode 755 ; files 
created with mode 666 become mode 644). 

If 000 is omitted, the current value of the mask is printed. 

umask is recognized and executed by the shell. By default, login 
shells have a umask of 022. 

umask is built in to csh and sh. 

See Also 


chmod(C), csh(C), sh(C), chmod(S), creat(S), umask(S) 

Standards Conformance 


umask is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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uname_ 

prints the name of the current system 

Syntax 

uname [ -snrvma ] 
uname [ -S system name ] 

Description 

The uname command prints the current system name of the UNIX sys¬ 
tem on the standard output file. It is mainly useful to determine which 
system one is using. The options cause selected information returned 
by uname (S) to be printed: 

-s print system name (default). 

-n print nodename (the nodename is the name by which the system 
is known to a communications network). 

-r print the operating system release. 

-v print the operating system version. 

-m print the machine hardware name. 

-a print all the above information. 

On your computer, the system name and the nodename may be 
changed by specifying a system name argument to the -S option. The 
system name argument is restricted to 8 characters. Only the super- 
user is allowed this capability. 

See Also 


uname(S) 

Standards Conformance 


uname is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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uniq _ 

reports repeated lines in a file 

Syntax 


uniq [ -udc [ +n ] [ -n ] ] [ input [ output ] ] 

Description 


uniq reads the input file and compares adjacent lines. In the normal 
case, the second and succeeding copies of repeated lines are removed; 
the remainder is written on the output file. Input and output should 
always be different. Note that repeated lines must be adjacent in order 
to be found; see sort(C). If the -u flag is used, just the lines that are 
not repeated in the original file are output. The -d option specifies 
that one copy of just the repeated lines is to be written. The normal 
mode output is the union of the -u and -d mode outputs. 

The -c option supersedes -u and -d and generates an output report in 
default style but with each line preceded by a count of the number of 
times it occurred. 

The n arguments specify skipping an initial portion of each line in the 
comparison: 

-n The first n fields together with any blanks before each are 
ignored. A field is defined as a string of nonspace, nontab 
characters separated by tabs and spaces from its neighbors. 

+n The first n characters are ignored. Fields are skipped before 
characters. 

See Also 


comm(C), sort(C) 

Standards Conformance 


uniq is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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units 

converts units 


Syntax 

units 

Description 

units converts quantities expressed in various standard scales to their 
equivalents in other scales. It works interactively in this fashion: 

You have: inch 
You want: cm 

* 2.540000e+00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of units 
optionally preceded by a numeric multiplier. Powers are indicated by 
suffixed positive integers, division is shown by the usual sign: 

You have: 15 lbs force/in2 
You want: atm 

* 1.020689e+00 
/9.797299e-01 

units only does multiplicative scale changes; thus it can convert Kel¬ 
vin to Rankine, but not Centigrade to Fahrenheit. Most familiar units, 
abbreviations, and metric prefixes are recognized, as well as the fol¬ 
lowing: 

pi Ratio of circumference to diameter 

c Speed of light 

e Charge on an electron 

g Acceleration of gravity 

force Same as g 
mole 

Avogadro’s number 

water 

Pressure head per unit height of water 


March 15, 1989 


UNITS-1 








UNITS (C) 


UNITS (C) 


au Astronomical unit 

Pound is not recognized as a unit of mass; lb is. Compound names are 
run together, (e.g. lightyear). British units that differ from their US 
counterparts are prefixed with “br”. For a complete list of units, 
enter: 

cat /usr/lib/unittab 


Files 


/usr/lib/unittab 
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uptime _ 

displays information about system activity 

Syntax 


uptime 

Description 

uptime prints the current time of day, the length of time the system has 
been up, and the number of users logged onto the system. On systems 
that maintain the necessary data, load averages are also shown. Load 
averages are the number of processes in the run queue averaged over 
1, 5, and 15 minutes. All of this information is also contained in the 
first line of the w(C) command. 

See Also 


w(C) 
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usemouse ___ 

maps mouse input to keystrokes for use with non¬ 

mouse based programs 

Syntax 


usemouse [ -f conffile ] [ -t type ] [ -h horiz_sens ] [ -v vert_sens ] 
[-ccmd] [-b] parameters 

Description 


This utility allows you to use a mouse with any program that would 
otherwise accept only keyboard input. 

For example, you can use a mouse with v/(C) to move the cursor 
around the screen and generate your most commonly used vi com¬ 
mands. The usemouseJC) command translates mouse input into 
specific keystrokes required by a program. You can use any of several 
predefined mouse keystroke sets (called maps) that correspond to dif¬ 
ferent popular programs. You can also define your own maps with 
keystrokes that match different mouse movements and mouse buttons. 

Options 


The options are: 


-f conffile 

The -f flag may be used to select an alternate configuration file. 
The alternate configuration file, conffile, should use the format of 
/etc/default/usemouse and be entered as an absolute pathname on 
the command line. For example: 

usemouse -f /u/daniel/mouseconf 

is the correct form to specify an alternate configuration file. The -f 
and -t flags are mutually exclusive. 


-t type 

The -t flag may be used to select a predefined configuration file. 
type can be the name of any file in /usr/lib/mouse, such as vi, 
rogue, or any others the system administrator chooses to place 
there. These files are identical in format to /etc/default/usemouse. 

-h horiz_sens 

Defines the horizontal sensitivity. Horizontal mouse movements 
smaller than this threshold are ignored. Mouse movements that are 
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multiples of this value generate multiple strings. The sensitivity 
defaults to 5 units. The minimum value is 1 unit, and the max¬ 
imum is 100 units. The lower the value, the more sensitive your 
mouse is to motion. Note that setting a high value may cause your 
mouse to behave as though it is not functioning, due to the large 
motion required to generate a signal. 

-v vert_sens 

Defines the vertical sensitivity. Vertical mouse movements 
smaller than this threshold are ignored. Mouse movements that are 
multiples of this value generate multiple strings. The sensitivity 
defaults to 5 units. The minimum value is 1 unit, and the max¬ 
imum is 100 units. The lower the value, the more sensitive your 
mouse is to motion. Note that setting a high value may cause your 
mouse to behave as though it is not functioning, due to the large 
motion required to generate a signal. 


-c cmd 


This option selects a command for usemouse to run. This defaults 
to the shell specified in the SHELL environment variable. If 
SHELL is unspecified, /bin/sh is used. Note that the command 
given with this flag can contain blank spaces if the entire command 
is placed within double quotes. For example: 

usemouse -c “vi /etc/termcap” 


is valid. 


-b Suppresses bell CG) for the duration of mouse usage. Useful with 


v/(C). 


parameters 

These are name=value pairs indicating what ASCII string to insert 
into the tty input stream, when the given event is received. Valid 
parameters include: 


rbu -string 
rbd =string 
mbu ^string 
mbd ^string 
lbu ^string 
lbd ^string 
vi=string 
It ^string 
up =string 
dn =string 
u\=string 
m=string 


String to generate on right button up 
String to generate on right button down 
String to generate on middle button up 
String to generate on middle button down 
String to generate on left button up 
String to generate on left button down 
String to generate on mouse right 
String to generate on mouse left 
String to generate on mouse up 
String to generate on mouse down 
String to generate on mouse up-left 
String to generate on mouse up-right 
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dr=string 
dl =string 
hsens =num 
vsens=/jM/n 
bells =-yes/no 


String to generate on mouse down-left 
String to generate on mouse down-right 
Sensitivity to horizontal motion 
Sensitivity to vertical motion 
Whether to remove 'G characters 


Parameters may be specified in any order. They may contain octal 
escapes. They may be quoted with single or double quotes if they con¬ 
tain blank spaces. Any parameters may be omitted and their value, if 
any, is taken from the configuration file. 


The usemouse(C) Command 

To start using the mouse with a text program, enter the command: 

usemouse 

This command sets the mouse for use with the default map, which is 
found in /etc/default/mouse. Alternate map files can be found in the 
directory /usr/lib/mouse. You can create your own alternate map files 
and place them in this directory or in your own custom map file direc¬ 
tory. The default map file has the following values: 


Mouse 

Keystroke 

Left Button 

v/ top of file (1G) command 

Middle Button 

vz delete character (x) command 

Right Button 

vz bottom of file (G) command 

Up 

Up Arrow Key 

Down 

Down Arrow Key 

Left 

Left Arrow Key 

Right 

Right Arrow Key 

Up and Left 

not defined 

Up and Right 

not defined 

Down and Left 

not defined 

Down and Right 

not defined 

Bells 

no 


Invoking the usemouse command without specifying any options 
makes the mouse ready for use with a wide variety of programs or 
applications. Invoking usemouse with no options causes the mouse to 
use the default keystroke map. Invoking the mouse in this way creates 
a new command shell. You can continue to use the mouse for the dura¬ 
tion of the shell. To terminate usemouse, simply enter Ctrl-D. 

You can also invoke usemouse for the duration of a specific command: 

usemouse -c command 
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This puts you in the program specified by command using the mouse. 
When you leave the program, mouse input is terminated. 


Using the Mouse with Specific Programs 

You can use any of several predefined maps that are set up specifically 
for use with different programs. (These maps are found in 
/usr/lib/mouse.) For example: 

usemouse -t vi 

This invokes the v/-specific map, which includes mapping the tradi¬ 
tional h-j-k-1 direction keys to the mouse movements. The terminal 
bell is automatically silenced by the vi map entry bells=no. This is 
done to prevent the bell being activated continuously when the user 
generates a spurious command with the mouse. (There is also a -b 
option that can be used on the usemouse command line to do the same 
thing.) 

You can combine a command with a selected map file by putting both 
on the command line. For example: 

usemouse -t vi -c vi filename 

This invokes the vi map along with the command; when you quit out 
of vi the mouse disengages. 


Setting Up Abbreviated (Aliased) Mouse Commands 

If you plan to use the mouse frequently, you can substitute short, easy 
to use commands that will call up the longer command lines. This is 
known as command aliasing. For more information on command alias¬ 
ing, consult the section “Using Aliases” in the “C-Shell” chapter of 
the Users Guide . 

Specifying Map Keystrokes on the Command Line 

You can also specify the characters to be generated by mouse motions 
on the usemouse command line. You can specify button actions or 
motion actions to supplement or replace a definition from a map file. 
For example, assume you want to use the default usemouse file, but 
you want to redefine the middle mouse button mbd (middle button 
down) as the vi “i” (insert) instead of the “x” (delete character) com¬ 
mand. The following command line does this: 

usemouse -c vi mbd=i 

The mouse operations are defined by a series of acronyms that are the 
same as used in the actual map file: 
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Parameter Mouse Operation 

Default 

rbu 

right button up 

not used 

rbd 

right button down 

1G 

mbu 

middle button up 

not used 

mbd 

middle button down 

X 

lbu 

left button up 

not used 

lbd 

left button down 

G 

ul 

mouse up-left 

\033[A\033[C 

ur 

mouse up-right 

\033[A\033[D 

dr 

mouse down-left 

\033[B\033[C 

dl 

mouse down-right 

\033[B\033[D 

rt 

mouse right 

\033[C 

It 

mouse left 

\033[D 

up 

mouse up 

\033[A 

dn 

mouse down 

\033[B 

hsens 

horiz. sensitivity 

5 

vsens 

vert, sensitivity 

5 


Creating Customized Maps 

You can create your own personal map files for use with the mouse. 
The easiest way to do this is to copy the default map in 
/etc/default/usemouse and edit it. You can use quoted strings or the 
octal sequences found in the ascii( M) page. The mouse 
direction/button parameters are defined in the usemouse table above. 
For example, after placing a customized file, mine, in your home 
directory, you would invoke the following command to use it with the 
program prog: 

usemouse -f mine -c prog 
How usemouse Works 

usemouse merges data from a mouse into the input stream of a tty. The 
mouse data is translated to arrow keys or any other arbitrary ASCII 
strings. Mouse movements up, down, left right, up-left, up-right, 
down-left, and down-right, as well as individual up and down button 
transitions, are programmable. This permits the mouse to be used 
with programs that are not designed to accept mouse input. 

By default, the usemouse utility gets value configurations from the file 

/etc/default/usemouse . 

After running the utility, provided a mouse is available, the user will 
be running a command with mouse motions and button events 
translated to ASCII strings and merged into their tty input stream. By 
default, the command is a shell. 
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/dev/mouse 
/dev/mouse/bus [0-1 ] 

/de v/mouse/vpix [0-1 ] 

/dev/mouse/microsoft_ser 

/dev/mouse/logitech_ser 

/dev/mouse/mousesys_ser 

/dev/mouse/ttyp [0-7] 

/dev/mouse/ptyp[0-7] 

/etc/default/usemouse 

/usr/lib/event/devices 

/usr/lib/event/ttys 

/usr/Iib/mouse/* 

Directory for mouse-related special device files. 
Bus mouse device files, 
vpix-mouse device files. 

Microsoft serial mouse device files. 

Logitech serial mouse device files. 

Mousesys serial mouse device files. 

Special pseudo-tty files for mouse input. 

Special pseudo-tty files for mouse input. 

Default map file for mouse-generated characters. 
File containing device information for mice. 

File listing ttys eligible to use mice. 

Alternate map files for mice. 

See Also 



mouse(HW) 
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uucp, uulog, uuname 

UNIX-to-UNIX system copy 

Syntax 


uucp [ options ] source-files destination-file 

uulog [ options ] -s system 

uulog [ options ] system 

uulog [ options ] -f system 

uuname [ -1 ] [ -c ] 

Description 


uucp copies files named by the source-file arguments to the 
destination-file argument. A file name may be a path name on your 
machine, or may have the form: 

system-name! path-name 

where system-name is taken from a list of system names that uucp 
knows about. The system-name may also be a list of names such as 

system-name! system-name!...! system-name !path-name 

in which case an attempt is made to send the file via the specified 
route, to the destination. See Warnings and Notes below for restric¬ 
tions. Care should be taken to ensure that intermediate nodes in the 
route are willing to forward information (see Warnings below for res¬ 
trictions). 


The shell metacharacters ?, * and [...] appearing in path-name will 
be expanded on the appropriate system. 

Path names may be one of: 

(1) a full path name; 

(2) a path name preceded by ~ user where user is a login name 
on the specified system and is replaced by that user’s login 
directory; 

(3) a path name preceded by 7 destination where destination is 
appended to /usr/spool/uucppublic; (NOTE: This destina¬ 
tion will be treated as a file name unless more than one file is 
being transferred by this request or the destination is already 
a directory. To ensure that it is a directory, follow the desti¬ 
nation with a ’/’. For example 7dan/ as die destination will 
make the directory /usr/spool/uucppublic/dan if it does not 
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exist and put the requested file(s) in that directory). 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system the copy 
will fail. If the destination-file is a directory, the last part of the 
source-file name is used. 

uucp preserves execute permissions across the transmission and gives 
0666 read and write permissions (see chmod( S)). 

The following options are interpreted by uucp : 

-c Do not copy local file to the spool directory for transfer to 

the remote machine (default). 

*-C Force the copy of local files to the spool directory for 

transfer. 

-d Make all necessary directories for the file copy (default). 

-f Do not make intermediate directories for the file copy. 

-g grade Grade is a single letter/number; lower ascii sequence 

characters will cause the job to be transmitted earlier dur¬ 
ing a particular conversation. 

-j Output the job identification ASCII string on the standard 

output. This job identification can be used by uustat to 
obtain the status or terminate a job. 

-m Send mail to the requester when the copy is completed. 

-n user Notify user on the remote system that a file was sent. 

-r Do not start the file transfer, just queue the job. 

-s file Report status of the transfer to file. Note that the file must 

be a full path name. 

-xdebugjevel 

Produce debugging output on standard output. The 
debug Jevel is a number between 0 and 9; higher numbers 
give more detailed information. 

uulog queries a log file of uucp or uuxqt transactions in a file 
lusrlspooMuucp/.Logluucicolsystem, or 

/usr/spool/uucp/Xog/uuxqt/system. 

The options cause uulog to print logging information: 


March 15,1989 


UUCP-2 





UUCP(C) 

UUCP(C) 

-s sys 

Print information about file transfer work involving sys¬ 
tem sys. 

-fsystem 

Does a “tail -f” of the file transfer log for system. (You 
must press DELETE or BREAK to exit this function.) 
Other options used in conjunction with the above: 

-X 

Look in the uuxqt log file for the given system, instead of 
the uucico log file (default). 

number 

Indicates that a “tail” command of number lines should 
be executed. 


uuname lists the names of systems known to uucp. The -c option 
returns the names of systems known to cu. (The two lists are the 
same, unless your machine is using different Systems files for cu and 
uucp. See the Sysfiles file.) The -1 option returns the local system 
name. 


Files 


/usr/spool/uucp 

spool directories 

/usr/spool/uucppublic/ *public directory for receiving and 

/usr/lib/uucp/* 

sending (/usr/spool/uucppublic) 
other data and program files 

See Also 


mail(C), uustat(C), uux(C), uuxqt(C), chmod(S) 

Warnings 



The domain of remotely accessible files can (and for obvious security 
reasons, usually should) be severely restricted. You will very likely 
not be able to fetch files by path name; ask a responsible person on the 
remote system to send them to you. For the same reasons you will 
probably not be able to send files to arbitrary path names. As distri¬ 
buted, the remotely accessible files are those whose names begin 
/usr/spool/uucppublic (equivalent to 7). 

All files received by uucp will be owned by uucp. The -m option will 
only work sending files or receiving a single file. Receiving multiple 
files specified by special shell characters ? * [... ] will not activate 
the -m option. 

The forwarding of files through other systems may not be compatible 
with the previous version of uucp. If forwarding is used, all systems in 
the route must have the same version of uucp. 
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Notes 


Protected files and files that are in protected directories that are owned 
by the requester can be sent by uucp. However, if the requester is 
root, and the directory is not searchable by “other” or the file is not 
readable by “other,” the request will fail. 

Standards Conformance 


uucp, uulog and uuname are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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uuencode, uudecode _ 

encode/decode a binary file for transmission via mail 

Syntax 

uuencode [ source ] remotedest I mail sysl !sys2!..!decode 
uudecode [ file ] 

Description 


uuencode and uudecode are used to send a binary file via uucp (or 
other) mail. This combination can be used over indirect mail links. 

uuencode takes the named source file (default standard input) and pro¬ 
duces an encoded version on the standard output. The encoding uses 
only printing ASCII characters, and includes the mode of the file and 
the remotedest for recreation on the remote system. 

uudecode reads an encoded file, strips off any leading and trailing 
lines added by mailers, and recreates the original file with the speci¬ 
fied mode and name. 

The intent is that all mail to the user “decode” should be filtered 
through the uudecode program. This way the file is created automati¬ 
cally without human intervention. This is possible on the uucp net¬ 
work by either using sendmail or by making rmail be a link to mail 
instead of mail . In each case, an alias must be created in a master file 
to get the automatic invocation of uudecode. 

If these facilities are not available, the file can be sent to a user on the 
remote machine who can uudecode it manually. 

The encode file has an ordinary text form and can be edited by any 
text editor to change the mode or remote name. 

See Also 


uucp(C), uux(ADM), mail(C) 
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Restrictions 

The file is expanded by 35% (3 bytes become 4 plus control informa¬ 
tion) causing it to take longer to transmit. 

The user on the remote system who is invoking uudecode (often uucp) 
must have write permission on the specified file. 
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uucp status inquiry and job control 

Syntax 


uustat [-a] 

uustat [-m] 

uustat [-p] 

uustat [-q] 

uustat [ -k jobid ] 

uustat [ -r jobid ] 

uustat [ -ssystem ] [ -uuser ] 

Description 


uustat will display the status of, or cancel, previously specified uucp 
commands, or provide general status on uucp connections to other sys¬ 
tems. Only one of the following options can be specified with uustat 
per command execution: 

-a Output all jobs in queue. 

-m Report the status of accessibility of all machines. 

“P Execute a ‘ ‘ps -flp’ ’ for all the process-ids that are in the 

lock files. 

"Q List the jobs queued for each machine. If a status file 

exists for the machine, its date, time and status informa¬ 
tion are reported. In addition, if a number appears in () 
next to the number of C or X files, it is the age in days of 
the oldest C./X. file for that system. The Retry field 
represents the number of hours until the next possible call. 
The Count is the number of failure attempts. NOTE: for 
systems with a moderate number of outstanding jobs, this 
could take 30 seconds or more of real-time to execute. As 
an example of the output produced by the -q option: 

eagle 3C 04/07-11:07NO DEVICES AVAILABLE 

mh3bs3 2C 07/07-10:42SUCCESSFUL 

The above output tells how many command files are wait¬ 
ing for each system. Each command file may have zero or 
more files to be sent (zero means to call the system and 
see if work is to be done). The date and time refer to the 
previous interaction with the system followed by the 
status of the interaction. 

■k jobid Kill the uucp request whose job identification is jobid. 

The killed uucp request must belong to the person issuing 
the uustat command unless one is the super-user. 
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-rjobid Rejuvenate jobid. The files associated with jobid are 
touched so that their modification time is set to the 
current time. This prevents the cleanup daemon from 
deleting the job until the jobs modification time reaches 
the limit imposed by the daemon. 


Either or both of the following options can be specified with uustat: 

-ssys Report the status of all uucp requests for remote system 
sys. 

-uuser Report the status of all uucp requests issued by user. 


Output for both the -s and -u options has the following format: 

eaglenOOOO 4/07-11:01:03(POLL) 

eagleNlbd7 4/07-11:07 Seagledan522 /usr/dan/A 

eagleClbd8 4/07-11:07 Seagledan59 D.3b2al2ce4924 

4/07-11:07 Seagledanrmail mike 


With the above two options, the first field is the jobid of the job. This 
is followed by the date/time. The next field is either an ’S’ or ’R’ 
depending on whether the job is to send or request a file. This is fol¬ 
lowed by the user-id of the user who queued the job. The next field 
contains the size of the file, or in the case of a remote execution ( 
rmail - the command used for remote mail), the name of the command. 
When the size appears in this field, the file name is also given. This 
can either be the name given by the user or an internal name (e.g., 
D.3b2alce4924) that is created for data files associated with remote 
executions ( rmail in this example). 

When no options are given, uustat outputs the status of all uucp 
requests issued by the current user. 


Files 


/usr/spool/uucp/* spool directories 

See Also 

uucp(C) 

Standards Conformance 


uustat is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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uuto, uupick _ 

public UNIX-to-UNIX system file copy 

Syntax 

uuto [ options ] source-files destination 
uupick [ -s system ] 

Description 


uuto sends source-files to destination, uuto uses the uucp(C) facility 
to send files, while it allows the local system to control the file access. 
A source-file name is a path name on your machine. Destination has 
the form: 

system 

where system is taken from a list of system names that uucp knows 
about (see uuname). User is the login name of someone on the speci¬ 
fied system. 

Two options are available: 

-p Copy the source file into the spool directory before transmis¬ 
sion. 

-m Send mail to the sender when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUBDIR 
on system , where PUBDIR is a public directory defined in the uucp 
source. By default this directory is /usr/spool/uucppublic. 
Specifically the files are sent to 

VUBDTRlvQCQivel user/mysystem/ flits. 

The destined recipient is notified by mail(C) of the arrival of files. 

uupick accepts or rejects the files transmitted to the user. Specifically, 
uupick searches PUBDIR for files destined for the user. For each entry 
(file or directory) found, the following message is printed on the stan¬ 
dard output: 

from system: [file file-name] [dir dirname ] ? 

uupick then reads a line from the standard input to determine the 
disposition of the file: 

<new-line> Go on to next entry. 
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d Delete the entry. 

m [ dir ] Move the entry to named directory dir. If dir is not 

specified as a complete path name (in which 
$HOME is legitimate), a destination relative to the 
current directory is assumed. If no destination is 
given, the default is the current directory. 

a [ dir ] Same as m except moving all the files sent from 

system. 

p Print the content of the file. 

q Stop. 

EOT (control-d) Same as q. 

!command Escape to the shell to do command . 

* Print a command summary. 

uupick invoked with the -s system option will only search the PUBDIR 

for files sent from system . 


Files 

PUBDIR /usr/spool/uucppublic public directory 

See Also 


mail(C), uucp(C), uustat(C), uux(C), uuclean(ADM) 

Warnings 


In order to send files that begin with a dot (e.g., .profile) the files must 
by qualified with a dot. For example: .profile, .prof*, .profil? are 
correct; whereas *prof*, ?profile are incorrect. 

Standards Conformance 


uupick and uuto are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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UUX _ 

UNIX-to-UNIX system command execution 

Syntax 


uux [ options ] command-string 

Description 


uux will gather zero or more files from various systems, execute a 
command on a specified system and then send standard output to a file 
on a specified system. 

NOTE: For security reasons, most installations limit the list of com¬ 
mands executable on behalf of an incoming request from uux , permit¬ 
ting only the receipt of mail (see mail(C)). (Remote execution per¬ 
missions are defined in /usr/lib/uucp/Permissions.) 

The command-string is made up of one or more arguments that look 
like a shell command line, except that the command and file names 
may be prefixed by system-name !. A null system-name is interpreted 
as the local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by "xxx where xxx is a login name on 
the specified system and is replaced by that user’s login 
directory; 

(3) anything else is prefixed by the current directory. 

As an example, the command 

uux "! diff usg!/usr/dan/file 1 pwba!/a4/dan/file2 > r/dan/file.difiT 

will get the file 1 and file2 files from the “usg” and “pwba” machines, 
execute a diff(C) command and put the results in file.diff in the local 
PUBDIR/dan/ directory. 

Any special shell characters such as <>;| should be quoted either by 
quoting the entire command-string, or quoting the special characters 
as individual arguments. 

uux will attempt to get all files to the execution system. For files that 
are output files, the file name must be escaped using parentheses. For 
example, the command 
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uux a!cut -fl b!/usr/file \(c!/usr/file\) 

gets /usr/file from system “b” and sends it to system “a”, performs a 
cut command on that file and sends the result of the cut command to 
system “c”. 

uux will notify you if the requested command on the remote system 
was disallowed. This notification can be turned off by the -n option. 
The response comes by remote mail from the remote machine. 

The following options are interpreted by uux : 

The standard input to uux is made the standard input to 
the command-string . 

-a name Use name as the user identification replacing the initiator 

user-id. (Notification will be returned to the user.) 

-b Return whatever standard input was provided to the uux 

command if the exit status is non-zero. 

-c Do not copy local file to the spool directory for transfer to 

the remote machine (default). 

-C Force the copy of local files to the spool directory for 

transfer. 

-g grade Grade is a single letter/number; lower ASCII sequence 

characters will cause the job to be transmitted earlier dur¬ 
ing a particular conversation. 

-j Output the jobid ASCII string on the standard output 

which is the job identification. This job identification can 
be used by uustat to obtain the status or terminate a job. 

-n Do not notify the user if the command fails. 

-p Same as -: The standard input to uux is made the standard 

input to the command-string . 

-r Do not start the file transfer, just queue the job. 

-s file Report status of the transfer in file. 

-xdebugjevel 

Produce debugging output on the standard output. The 
debug level is a number between 0 and 9; higher numbers 
give more detailed information. 

-z Send success notification to the user. 
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Files 


/usr/spool/uucp/* 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/* 

spool directories 

remote execution permissions 

other data and programs 

See Also 


mail(C), uucp(C), uustat(C) 


Warnings 



Only the first command of a shell pipeline may have a system-name 
All other commands are executed on the system of the first command. 
The use of the shell metacharacter * will probably not do what you 
want it to do. The shell tokens « and » are not implemented. 

The execution of commands on remote systems takes place in an exe¬ 
cution directory known to the uucp system. All files required for the 
execution will be put into this directory unless they already reside on 
that machine. Therefore, the simple file name (without path or 
machine reference) must be unique within the uux request. The fol¬ 
lowing command will NOT work: 

uux "aldiff b!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.diff" 
but the command 

uux "aldiff a!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.diff" 
will work. (If diff is a permitted command.) 

Notes 


Protected files and files that are in protected directories that are owned 
by the requester can be sent in commands using uux. However, if the 
requester is root, and the directory is not searchable by “other,” the 
request will fail. 

Standards Conformance 


uux is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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VC_ 

version control 


Syntax 


vc [-a] [-t] [-cchar] [-s] [keyword=value ... keyword=value] 


Description 

The vc command copies lines from the standard input to the standard 
output under control of its arguments and control statements encoun¬ 
tered in the standard input. In the process of performing the copy 
operation, user declared keywords may be replaced by their string 
value when they appear in plain text and/or control statements. 

The copying of lines from the standard input to the standard output is 
conditional, based on tests (in control statements) of keyword values 
specified in control statements or as vc command arguments. 

A control statement is a single line beginning with a control character, 
except as modified by the -t keyletter (see below). The default control 
character is colon (:), except as modified by the -c keyletter (see 
below). Input lines beginning with a backslash (\) followed by a con- J 
trol character are not control lines and are copied to the standard out- 
put with the backslash removed. Lines beginning with a backslash 
followed by a non-control character are copied in their entirety. 

A keyword is composed of 9 or fewer alphanumerics; the first must be 
alphabetic. A value is any ASCII string that can be created with 
ed{C)\ a numeric value is an unsigned string of digits. Keyword 
values may not contain blanks or tabs. 

Replacement of keywords by values is done whenever a keyword sur¬ 
rounded by control characters is encountered on a version control 
statement. The -a keyletter (see below) forces replacement of key¬ 
words in all lines of text. An uninterpreted control character may be 
included in a value by preceding it with \. If a literal \ is desired, then 
it too must be preceded by \. 


Keyletter Arguments 


-a Forces replacement of keywords surrounded by control char¬ 
acters with their assigned value in all text lines and not just in 
vc statements. 


-t All characters from the beginning of a line up to and including 
the first tab character are ignored for the purpose of detecting 
a control statement. If one is found, all characters up to and 
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including the tab are discarded. 

"C char Specifies a control character to be used in place of the colon. 

■s Silences warning messages (not error) that are normally 

printed on the diagnostic output. 

Version Control Statements 

:dcl keyword^ ..., keyword] 

Used to declare keywords. All keywords must be declared. 

:asg keyword=value 

Used to assign values to keywords. An asg statement overrides 
the assignment for the corresponding keyword on the vc com¬ 
mand line and all previous asg’s for that keyword. Keywords 
declared, but not assigned values have null values. 

:if condition 


rend 

Used to skip lines of the standard input. If the condition is true, 
all lines between the if statement and the matching end state¬ 
ment are copied to the standard output. If the condition is false, 
all intervening lines are discarded, including control statements. 
Note that intervening if statements and matching end state¬ 
ments are recognized solely for the purpose of maintaining the 
proper if-end matching. 

The syntax of a condition is: 


<cond> 

<or> 

<and> 

<exp> 

<op> 

<value> 


= [ "not” ] <or> 

= <and> I <and> T <or> 

= <exp> I <exp> <and> 

= "(" <or> ")" I <value> <op> <value> 

_ »»_»» j »»J = II | j If^ll 

= <arbitrary ASCII string> I <numeric string> 


The available operators and their meanings are: 


= equal 

!= not equal 

& and 

I or 

> greater than 

< less than 

() used for logical groupings 

not may only occur immediately after the if , and when 
present, inverts the value of the entire condition 
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The > and < operate only on unsigned integer values (e.g.,: 012 
> 12 is false). All other operators take strings as arguments 
(e.g.,: 012 != 12 is true). The precedence of the operators (from 
highest to lowest) is: 

= != > < all of equal precedence 
& 

I 

Parentheses may be used to alter the order of precedence. 

Values must be separated from operators or parentheses by at 
least one blank or tab. 

::text Used for keyword replacement on lines that are copied to the 
standard output. The two leading control characters are 
removed, and keywords surrounded by control characters in text 
are replaced by their value before the line is copied to the output 
file. This action is independent of the -a keyletter. 

:on 

:off Turn on or off keyword replacement on all lines. 

:ctl char 

Change the control character to char. 

:msg message 

Prints the given message on the diagnostic output. 

:err message 

Prints the given message followed by: 

ERROR: err statement on line ... (915) 
on the diagnostic output, vc halts execution and returns an exit 
code of 1. 

See Also 


ed(C) 

Diagnostics 

0 - normal 
1 - any error 
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vi, view, vedit _ 

invokes a screen-oriented display editor 

Syntax 


vi [ -option ... ] [ command ... ] [ filename ... ] 
view [ -option ... ] [ command ... ] [ filename ... ] 
vedit [ -option ... ] [ command ... ] [ filename ... ] 

Description 


vi offers a powerful set of text editing operations based on a set of 
mnemonic commands. Most commands are single keystrokes that 
perform simple editing functions, vi displays a full screen “window” 
into the file you are editing The contents of this window can be 
changed quickly and easily within vi. While editing, visual feedback 
is provided (the name vi itself is short for “visual” ). 

The view command is the same as vi except that the read-only option 
(-R) is set automatically. The file cannot be changed with view . 

The vedit command is the same as vi except for differences in the 
option settings, vedit uses novice mode, turns off the magic option, 
sets the option report=l and turns on the options showmode and 
redraw. 

The showmode option informs the vedit user, in a message in the 
lower right hand comer of the screen, which mode is being used. For 
instance after the ESC-i command is used, the message reads 
“INSERT MODE”. 6 

Note that you can not set the novice option from within vi or ex. If 
you want to use the novice option you must use the vedit utility. (It is 
possible to set the nonovice option from within vedit.) 

vi and the line editor ex are one and the same editor: the names vi and 
ex identify a particular user interface rather than any underlying func¬ 
tional difference. The differences in user interface, however, are quite 
striking, ex is a powerful line-oriented editor, similar to the editor ed. 
However, in both ex and ed, visual updating of the terminal screen is 
limited, and commands are entered on a command line, vi, on the 
other hand, is a screen-oriented editor designed so that what you see 
on the screen corresponds exactly and immediately to the contents of 
the file you are editing. In the following discussion, vi commands and 
options are printed in boldface type. 
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Options available on the vi command line include: 

-x Encryption option; when used, the file will be encrypted as it is 
being written and will require an encryption key to be read, vi 
makes an educated guess to determine if a file is encrypted or not. 
See crypt ( C). Also, see the Notes section at the end of this manual 
page. 

-C Encryption option; the same as -x except that vi assumes files are 
encrypted. 

-c command 

Begin editing by executing the specified editor command 
(usually a search or positioning command). 

-t tag Equivalent to an initial tag command; edits the file con- 
tainin. tag and positions the editor at its definition. 

-rfile Used in recovering after an editor or system crash, 
retrieves the last saved version of the named file. 

-1 Specific to editing LISP, this option sets the showmatch 

and lisp options. 

-L List the names of all files saved as a result of an editor or 

system crash. Files may be recovered with the -r option. 

-wn Sets the default window size to n. Useful on dialups to 

start in small windows. 

-R Sets a read-only option so that files can be viewed but not 

edited. 


The Editing Buffer 

vi performs no editing operations on the file that you name during 
invocation. Instead, it works on a copy of the file in an “editing 
buffer.” 

When you invoke vi with a single filename argument, the named file is 
copied to a temporary editing buffer. The editor remembers the name 
of the file specified at invocation, so that it can later copy the editing 
buffer back to the named file. The contents of the named file are not 
affected until the changes are copied back to the original file. 


Modes of Operation 

Wi thin vi there are three distinct modes of operation: 
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Command Mode 


Insert Mode 


ex Escape Mode 


Within command mode, signals from the 
keyboard are interpreted as editing com¬ 
mands. 

Insert mode can be entered by typing any 
of the vz insert, append, open, substitute, 
change, or replace commands. Once in 
insert mode, letters typed at the key¬ 
board are inserted into the editing buffer. 

The vz and ex editors are one and the 
same editor differing mainly in their user 
interface. In vz , commands are usually 
single keystrokes. In ex, commands are 
lines of text terminated by a RETURN, 
vz has a special “escape” command that 
gives access to many of these line- 
oriented ex commands. To use the ex 
escape mode, type a colon (:). The colon 
is echoed on the status line as a prompt 
for the ex command. An executing com¬ 
mand can be aborted by pressing INTER¬ 
RUPT. Most file manipulation com¬ 
mands are executed in ex escape mode 
(for example, the commands to read in a 
file and to write out the editing buffer to 
a file). 


Special Keys 

There are several special keys in vz. The following keys are used to 
edit, delimit, or abort commands and command lines. 

ESC Used to return to vz command mode or to cancel par¬ 

tially formed commands. 

RETURN Terminates ex commands when in ex escape mode. 
Also used to start a newline when in insert mode. 


INTERRUPT Often the same as the DEL or RUBOUT key on many 
terminals. Generates an interrupt, telling the editor to 
stop what it is doing. Used to abort any command that 
is executing. 

/ Used to specify a string to be searched for. The slash 

appears on the status line as a prompt for a search 
string. The question mark (?) works exactly like the 
slash key, except that it is used to search backward in a 
file instead of forward. 
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: The colon is a prompt for an ex command. You can 

then type in any ex command, followed by an ESC or 
RETURN, and the given ex command is executed. 

The following characters are special in insert mode: 

BKSP Backs up the cursor one character on the current line. The 
last character typed before the BKSP is removed from the 
input buffer, but remains displayed on the screen. 

Ctrl-U Moves the cursor back to the first character of the inser¬ 
tion and restarts insertion. 

Ctrl-V Removes the special significance of the next typed char¬ 
acter. Use Ctrl-V to insert control characters. Linefeed 
and Ctrl-J cannot be inserted in the text except as newline 
characters. Ctrl-Q and Ctrl-S are trapped by the operating 
system before they are interpreted by vi, so they too can¬ 
not be inserted as text. 

Ctrl-W Moves the cursor back to the first character of the last 
inserted word. 

Ctrl-T During an insertion, with the autoindent option set and at 
the beginning of the current line, entering this character 
will insert shiftwidth whitespace. 

Ctrl-@ If entered as the first character of an insertion, it is 
replaced with the last text inserted, and the insertion ter¬ 
minates. Only 128 characters are saved from the last 
insertion. If more than 128 characters were inserted, then 
this command inserts no characters. A Ctrl-@ cannot be 
part of a file, even if quoted. 


Starting and Exiting 
To enter vi, enter: 
vi 

vi file 
vi +123 file 
vi +45 file 
vi +/word file 
vi +/tty file 


vi 

Edits empty editing buffer 
Edits named file 
Goes to line 123 
Goes to line 45 

Finds first occurrence of “word" 
Finds first occurrence of “tty" 
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There are several ways to exit the editor: 

ZZ The editing buffer is written to the file only if any changes were 
made. 

:x The editing buffer is written to the file only if any changes were 
made. 

:q! Cancels an editing session. The exclamation mark (!) tells vi to 
quit unconditionally. In this case, the editing buffer is not writ¬ 
ten out. 

vi Commands 


vi is a visual editor with a window on the file. What you see on the 
screen is v/’s notion of what the file contains. Commands do not 
cause any change to the screen until the complete command is 
entered. Most commands may take a preceding count that specifies 
repetition of the command. This count parameter is not given in the 
following command descriptions, but is implied unless overridden by 
some other prefix argument. When vi gets an improperly formatted 
command, it rings a bell. 

Cursor Movement 

The cursor movement keys allow you to move your cursor around in a 
file. Note in particular the direction keys (if available on your termi¬ 
nal), the H, J, K, and L cursor keys, and SPACEBAR, BKSP, Ctrl-N, and 
Ctrl-P. These three sets of keys perform identical functions. 

Forward Space -1, SPACEBAR, or right direction key 

Syntax: I 

SPACEBAR 
right direction key 

Function: Moves the cursor forward one character. If a count is 
given, move forward count characters. You cannot move 
past the end of the line. 

Backspace - h, BKSP, or left direction key 

Syntax: h 

BKSP 

left direction key 

Function: Moves cursor backward one character. If a count is given, 
moves backward count characters. Note that you cannot 
move past the beginning of the current line. 
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Next Line - +, RETURN, j, Ctrl-N, and LF 

Syntax: + 

RETURN 

Function: Moves the cursor down to the beginning of the next line. 

Syntax: j 

Ctrl-N 

LF 

down direction key 

Function: Moves the cursor down one line, remaining in the same 
column. Note the difference between these commands 
and the preceding set of next line commands which move 
to the beginning of the next line. 

Previous Line - k, Ctrl-P, and up direction key 

Syntax: k 

Ctrl-P 

up direction key 

Function: Moves the cursor up one line, remaining in the same 
column. If a count is given, the cursor is moved count 
lines. 

Syntax: 

Function: Moves the cursor up to the beginning of the previous line. 
If a count is given, the cursor is moved up a count lines. 

Beginning of Line - 0 and A 

Syntax: 

0 

Function: Moves the cursor to the beginning of the current line. 

Note that 0 always moves the cursor to the first character 
of the current line. The caret ( A ) works somewhat 
differently: it moves to the first character on a line that is 
not a tab or a space. This is useful when editing files that 
have a great deal of indentation, such as program texts. 
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End of Line - $ 

Syntax: $ 

Function: Moves the cursor to the end of the current line. Note that 
the cursor resides on top of the last character on the line. 
If a count is given, the cursor is moved forward count-1 
lines to the end of the line. 

Goto Line - G 

Syntax: [ linenumber]G 

Function: Moves the cursor to the beginning of the line specified by 
linenumber . If no linenumber is given, the cursor moves 
to the beginning of the last line in the file. To find the line 
number of the current line, use Ctrl-G. 

Column -1 

Syntax: [column] | 

Function: Moves the cursor to the column in the current line given 
by column . If no column is given, the cursor is moved to 
the first column in the current line. 

Word Forward - w and W 

Syntax: w 

W 

Function: Moves the cursor forward to the beginning of the next 
word. The lowercase w command searches for a word 
defined as a string of alphanumeric characters separated 
by punctuation or whitespace (i.e., tab, newline, or space 
characters). The uppercase W command searches for a 
word defined as a string of nonwhitespace characters. 

Back Word - b and B 

Syntax: b 

B 

Function: Moves the cursor backward to the beginning of a word. 

The lowercase b command searches backward for a word 
defined as a string of alphanumeric characters separated 
by punctuation or whitespace (i.e., tab, newline, or space 
characters). The uppercase B command searches for a 
word defined as a string of non-whitespace characters. If 
the cursor is already within a word, it moves backward to 
the beginning of that word. 
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End - e and E 

Syntax: e 

E 

Function: Moves the cursor to the end of a word. The lowercase e 
command moves the cursor to the last character of a word, 
where a word is defined as a string of alphanumeric char¬ 
acters separated by punctuation or whitespace (i.e., tab, 
newline, or space characters). The uppercase E moves the 
cursor to the last character of a word where a word is 
defined as a string of nonwhitespace characters. If the 
cursor is already within a word, it moves to the end of that 
word. 

Sentence - (and) 

Syntax: ( 

) 

Function: Moves the cursor to the beginning (left parenthesis) or 
end of a sentence (right parenthesis). A sentence is 
defined as a sequence of characters ending with a period 
(.), question mark (?), or exclamation mark (!), followed 
by either two spaces or a newline. A sentence begins on 
the first nonwhitespace character following a preceding 
sentence. Sentences are also delimited by paragraph and 
section delimiters. See below. 

Paragraph - { and } 

Syntax: } 

{ 

Function: Moves the cursor to the beginning ({) or end (}) of a para¬ 
graph. A paragraph is defined with the paragraphs 
option. By default, paragraphs are delimited by the nrofif 
macros “.IP”, “.LP”, “P”, “.QP”, and “.bp”. Para¬ 
graphs also begin after empty lines. 

Section - [[ and ]] 

Syntax: ]] 

[[ 

Function: Moves the cursor to the beginning ([[) or end (]]) of a sec¬ 
tion. A section is defined with the sections option. By 
default, sections are delimited by the nroff macros “.NH” 
and “.SH”. Sections also start at formfeeds (Ctrl-L) and 
at lines beginning with a brace ({). 
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Match Delimiter - % 

Syntax: % 

Function: Moves the cursor to a matching delimiter, where a delim¬ 
iter is a parenthesis, a bracket, or a brace. This is useful 
when matching pairs of nested parentheses, brackets, and 
braces. 

Home - H 


Syntax: 

[offsem 

Function: 

Moves the cursor to the upper left comer of the screen. 
Use this command to quickly move to the top of the 
screen. If an offset is given, the cursor is homed offset-l 
number of lines from the top of the screen. Note that the 
command “dH” deletes all lines from the current line to 


the top line shown on the screen. 

Middle Screen - M 


Syntax: 

M 

Function: 

Moves the cursor to the beginning of the screen’s middle 
line. Use this command to quickly move to the middle of 
the screen from either the top or the bottom. Note that the 
command “dM” deletes from the current line to the line 


specified by the M command. 

Lower Screen - L 


Syntax: 

[offset] L 

Function: 

Moves the cursor to the lowest line on the screen. Use 
this command to quickly move to the bottom of the 
screen. If an offset is given, the cursor is homed offset -1 
number of lines from the bottom of the screen. Note that 
the command “dL” deletes all lines from the current line 
to the bottom line shown on the screen. 


Previous Context -" and " 


Syntax: 

'character 

'character 

Function: 

Moves the cursor to previous context or to context marked 
with the m command. If the single quotation mark or 
back quotation mark is doubled, the cursor is moved to 
previous context. If a single character is given after either 
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quotation mark, the cursor is moved to the location of the 
specified mark as defined by the m command. Previous 
context is the location in the file of the last “nonrelative” 
cursor movement. The single quotation mark (') syntax 
is used to move to the beginning of the line representing 
the previous context. The back quotation mark (') syntax 
is used to move to the previous context within a line. 



The Screen Commands 

The screen commands are not cursor movement commands and cannot 
be used in delete commands as the delimiters of text objects. How¬ 
ever, the screen commands do move the cursor and are useful in pag¬ 
ing or scrolling through a file. These commands are described below: 

Scroll- Ctrl-U and Ctrl-D 

Syntax: [size]Ctr\-U 

[$/ze]Ctrl-D 

Function: Scrolls the screen up a half window (Ctrl-U) or down a 


half window (Ctrl-D). If size is given, the scroll is size 
number of lines. This value is remembered for all later 
scrolling commands. 



Page - Ctrl-F and Ctrl-B 

Syntax: Ctrl-F 

Ctrl-B 

Function: Pages screen forward and backward. Two lines of con¬ 


tinuity are kept between pages if possible. A preceding 
count gives the number of pages to move forward or back¬ 
ward. 


Status - Ctrl-G 

Syntax: BELL 

Ctrl-G 

Function: Displays vi status on status line. This gives you the name 


of the file you are editing, whether it has been modified, 
the current line number, die number of lines in the file, 
and the percentage of the file (in lines) that precedes the 
cursor. 


Zero Screen - z 



Syntax: [linenumber]z[size]RET\JKN 


[linenumber]z[size\. 
[linenumber)z[size] - 
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Function: Redraws the display with the current line placed at or 
“zeroed” at the top, middle, or bottom of the screen, 
respectively. If you give a size , the number of lines 
displayed is equal to size. If a preceding linenumber is 
given, the given line is placed at the top of the screen. If 
the last argument is a RETURN, the current line is placed 
at the top of the screen. If the last argument is a period 
(.), the current line is placed in the middle of the screen. 
If the last argument is a minus sign (-), the current line is 
placed at the bottom of the screen. 

Redraw - Ctrl-R or Ctrl-L 

Syntax: Ctrl-R 

Ctrl-L 

(Command depends on terminal type.) 

Function: Redraws the screen. Use this command to erase any sys¬ 
tem messages that may scramble your screen. Note that 
system messages do not affect the file you are editing. 

Text Insertion 

The text insertion commands always place you in insert mode. Exit 
from insert mode is always done by pressing ESC. The following 
insertion commands are “pure” insertion commands; no text is 
deleted when you use them. This differs from the text modification 
commands, change, replace, and substitute, which delete and then 
insert text in one operation. 

Insert - i and I 

Syntax: i[/m]ESC 

I[tex/]ESC 

Function: Insert text in editing buffer. The lowercase i command 
places you in insert mode. Text is inserted before the 
character beneath the cursor. To insert a newline, press a 
RETURN. Exit insert mode by typing the ESC key. The 
uppercase I command places you in insert mode, but 
begins text insertion at die beginning of the current line, 
rather than before the cursor. 

Append - a and A 

Syntax: a[texr]ESC 

A[tetf]ESC 

Function: Appends text to the editing buffer. The lowercase a com¬ 
mand works exactly like the lowercase i command, except 
that text insertion begins after the cursor and not before. 
This is the one way to add text to the end of a line. The 
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uppercase A command begins appending text at the end of 
the current line rather than after the cursor. 

Open New Line - o and O 

Syntax: o[text]ESC 

0[text]ESC 

Function: Opens a new line and inserts text. The lowercase o com¬ 
mand opens a new line below the current line; uppercase 
O opens a new line above the current line. After die new 
line has been opened, both these commands work like the 
I command. 


Text Deletion 

Many of the text deletion commands use the D key as an operator. 

This operator deletes text objects delimited by the cursor and a cursor 

movement command. Deleted text is always saved away in a buffer. 

The delete commands are described below: 

Delete Character - x and X 

Syntax: x 

X 

Function: Deletes a character. The lowercase x command deletes 
the character beneath the cursor. With a preceding count, 
count characters are deleted to the right beginning with 
the character beneath the cursor. This is a quick and easy 
way to delete a few characters. The uppercase X com¬ 
mand deletes the character just before the cursor. With a 
preceding count, count characters are deleted backward, 
beginning with the character just before the cursor. 

Delete - d and D 

Syntax: d cursor-movement 

dd 

D 

Function: Deletes a text object. The lowercase d command takes a 
cursor-movement as an argument. If the cursor-movement 
is an intraline command, deletion takes place from the 
cursor to the end of the text object delimited by the 
cursor-movement . Deletion forward deletes the character 
beneath the cursor; deletion backward does not. If the 
cursor-movement is a multi-line command, deletion takes 
place from and including the current line to the text object 
delimited by the cursor-movement . 
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The dd command deletes whole lines. The uppercase D command 
deletes from and including the cursor to the end of the current line. 

Deleted text is automatically pushed on a stack of buffers numbered 1 
through 9. The most recently deleted text is also placed in a special 
delete buffer that is logically buffer 0. This special buffer is the 
default buffer for all (put) commands using the double quotation mark 
(") to specify the number of the buffer for delete, put, and yank com¬ 
mands. The buffers 1 through 9 can be accessed with the p and P (put) 
commands by appending the double quotation mark (") to the number 
of the buffer. For example: 

"4p 

puts the contents of delete buffer number 4 in your editing buffer just 
below the current line. Note that the last deleted text is “put” by 
default and does not need a preceding buffer number. 

Text Modification 

The text modification commands all involve the replacement of text 
with other text. This means that some text will necessarily be deleted. 
All text modification commands can be “undone” with the u com¬ 
mand: 

Undo - u and U 

Syntax: u 

U 

Function: Undoes the last insert or delete command. The lowercase 
u command undoes the last insert or delete command. 
This means that after an insert, u deletes text; and after a 
delete, u inserts text. For the purposes of undo, all text 
modification commands are considered insertions. 

The uppercase U command restores the current line to its 
state before it was edited, no matter how many times the 
current line has been edited since you moved to it. 

Repeat -. 

Syntax: 

Function: Repeats the last insert or delete command. A special case 
exists for repeating the p and P “put” commands. When 
these commands are preceded by the name of a delete 
buffer, successive u commands display the contents of the 
delete buffers. 
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Change - c and C 


Syntax: 

c cursor-movement text ESC 

C text ESC 
cc text ESC 

Function: 

Changes a text object and replaces it with text . Text is 
inserted as with the i command. A dollar sign ($) marks 
the extent of the change. The c command changes arbi¬ 
trary text objects delimited by the cursor and a cursor- 
movement . The C and cc commands affect whole lines 
and are identical in function. 


Replace - r and R 


Syntax: 

r char 

Rtext ESC 

Function: 

Overstrikes character or line with char or text , respec¬ 
tively. Use r to overstrike a single character and R to 
overstrike a whole line. A count multiplies the replace¬ 
ment text count times. 


Substitute - s and S 


Syntax: 

s text ESC 

S text ESC 

Function: 

Substitutes current character or current line with text. Use 
s to replace a single character with new text. Use S to 
replace the current line with new text. If a preceding 
count is given, text substitutes for count number of char¬ 
acters or lines depending on whether the command is s or 
S, respectively. 

Filter -! 


Syntax: 

Icursor-movement cmd RETURN 

Function: 

Filters the text object delimited by the cursor and cursor- 
movement through the UNIX command, cmd. For exam¬ 
ple, the following command sorts all lines between the 
cursor and the bottom of the screen, substituting the 
designated lines with the sorted lines: 

ILsort 

Arguments and shell metacharacters may be included as 
part of cmd; however, standard input and output are 
always associated with the text object being filtered. 
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Join Lines - J 

Syntax: J 

Function: Joins the current line with the following line. If a count is 
given, count lines are joined. 

Shift - < and > 

Syntax: >[cursor-movement ] 

<[cursor-movement ] 

» 

« 

Function: Shifts text right (>) or left (<). Text is shifted by the value 
of the option shiftwidth , which is normally set to eight 
spaces. Both the > and < commands shift all lines in the 
text object delimited by the current line and cursor- 
movement. The » and « commands affect whole lines. 
All versions of the command can take a preceding count 
that acts to multiply the number of objects affected. 


Text Movement 

The text movement commands move text in and out of the named 
buffers a-z and out of the delete buffers 1-9. These commands either 
“yank” text out of the editing buffer and into a named buffer or “put” 
text into the editing buffer from a named buffer or a delete buffer. By 
default, text is put and yanked from the “unnamed buffer”, which is 
also where the most recently deleted text is placed. Thus it is quite 
reasonable to delete text, move your cursor to the location where you 
want the deleted text placed, and then put the text back into the edit¬ 
ing buffer at this new location with the p or P command. 

The named buffers are most useful for keeping track of several chunks 
of text that you want to keep on hand for later access, movement, or 
rearrangement. These buffers are named with the letters a through z. 
To refer to one of these buffers (or one of the numbered delete buffers) 
in a command, use a quotation mark. For example, to yank a line into 
the buffer named a , enter: 

"ayy 

To put this text back into the file, enter: 

” a P 

If you delete text in the buffer named A rather than < 2 , text is appended 
to the buffer. 
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Note that the contents of the named buffers are not destroyed when 
you switch files. Therefore, you can delete or yank text into a buffer, 
switch files, and then do a put. Buffer contents are destroyed when you 
exit the editor, so be careful. 

Put - p and P 

Syntax: ["alphanumeric] p 

["alphanumeric]? 

Function: Puts text from a buffer into the editing buffer. If no buffer 
name is specified, text is put from the unnamed buffer. 
The lowercase p command puts text either below the 
current line or after the cursor, depending on whether the 
buffer contains a partial line or not. The uppercase P 
command puts text either above the current line or before 
the cursor, again depending on whether the buffer contains 
a partial line or not. 

Yank - y and Y 

Syntax: [” letter]^ cursor-movement 

["letter] yy 
["letter] Y 

Function: Copies text in the editing buffer to a named buffer. If no 
buffer name is specified, text is yanked into the unnamed 
buffer. If an uppercase letter is used, text is appended to 
the buffer and does not overwrite and destroy the previous 
contents. When a cursor-movement is given as an argu¬ 
ment, the delimited text object is yanked. The Y and yy 
commands yank a single line, or, if a preceding count is 
given, multiple lines can be yanked. 


Searching 

The search commands search either forward or backward in the edit¬ 
ing buffer for text that matches a given regular expression. 

Search - / and ? 

Syntax: l[pattern]l[offset]KET\JKN 

l[pattern]RET\]RN 
?[pattern]noffset] RETURN 
'[pattern] RETURN 

Function: Searches forward (/) or backward (?) for pattern . A string 
is actually a regular expression. The trailing delimiter is 
not required. If no pattern is given, then last pattern 
searched for is used. After the second delimiter, an offset 
may be given, specifying the beginning of a line relative 
to the line on which pattern was found. For example: 
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/word/- 

finds the beginning of the line immediately preceding the 
line containing “word” and the following command: 

/word/+2 

finds the beginning of the line two lines after the line con¬ 
taining “word”. See also the ignorecase and magic 
options. 

Next String - n and N 

Syntax: n 

N 

Function: Repeats the last search command. The n command 
repeats the search in the same direction as the last search 
command. The N command repeats the search in the 
opposite direction of the last search command. 

Find Character - f and F 

Syntax: f char 

Fchar 

9 

9 

Function: Finds character char on the current line. The lowercase f 
searches forward on the line; the uppercase F searches 
backward. The semicolon (;) repeats the last character 
search. The comma (,) reverses the direction of the 
search. 

To Character -1 and T 

Syntax: t char 

Tchar 


Function: Moves the cursor up to but not on char. The semicolon 
(;) repeats the last character search. The comma (,) rev¬ 
erses the direction of the search. 

Mark - m 

Syntax: m letter 

Function: Marks a place in the file with a lowercase letter . You can 
move to a mark using the “to mark” commands described 
below. It is often useful to create a mark, move the 
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cursor, and then delete from the cursor to the mark “a” 
with the following command: 

da 


To Mark -' and' 

Syntax: 'letter 

'letter 

Function: Move to letter. These commands let you move to the 
location of a mark. Marks are denoted by single lower¬ 
case alphabetic characters. Before you can move to a 
mark, it must first be created with the m command. The 
back quotation mark (') moves you to the exact location 
of the mark within a line; the forward quotation mark (') 
moves you to the beginning of the line containing the 
mark. Note that these commands are also legal cursor 
movement commands. 


Exit and Escape Commands 

There are several commands that are used to escape from vi command 

mode and to exit the editor. These are described in the following sec¬ 
tion. 

ex Escape -: 

Syntax: : 

Function: Enters ex escape mode to execute an ex command. The 
colon appears on the status line as a prompt for an ex 
command. You then can enter an ex command line ter¬ 
minated by either a RETURN or an ESC and the ex com¬ 
mand will execute. You are then prompted to type 
RETURN to return to vi command mode. During the input 
of the ex command line or during execution of the ex 
command, you may press INTERRUPT to stop what you 
are doing and return to vi command mode. 

Exit Editor - ZZ 

Syntax: ZZ 

Function: Exit vi and write out the file if any changes have been 
made. This returns you to the shell from which you 
started vi. 

Quit to ex - Q 
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Syntax: Q 

Function: Enters the ex editor. When you do this, you will still be 
editing the same file. You can return to vi by entering the 
vi command from ex. 

ex Commands 


Entering the colon (:) escape command when in command mode pro¬ 
duces a colon prompt on the status line. This prompt is for a command 
available in the line-oriented editor, ex. In general, ex commands let 
you write out or read in files, escape to the shell, or switch editing 
files. 

Many of these commands perform actions that affect the “current” 
file by default. The current file is normally the file that you named 
when you started vi, although the current file can be changed with the 
file command, f, or with the “next” command, n. In most respects, 
these commands are identical to similar commands for the editor, ed. 
All such ex commands are aborted by either RETURN or ESC. We 
shall use RETURN in our examples. Command entry is terminated by 
typing INTERRUPT. 


Command Structure 

Most ex command names are English words, and initial prefixes of the 
words are acceptable abbreviations. In descriptions, only the abbrevi¬ 
ation is discussed, since this is the most frequently used form of the 
command. The ambiguity of abbreviations is resolved in favor of the 
more commonly used commands. As an example, the command sub¬ 
stitute can be abbreviated s , while the shortest available abbreviation 
for the set command is se. 

Most commands accept prefix addresses specifying the lines in the file 
that they are to affect. A number of commands also may take a trail¬ 
ing count specifying the number of lines to be involved in the com¬ 
mand.^ Counts are rounded down if necessary. Thus, the command 
“lOp” displays the tenth line in the buffer while “move 5” moves the 
current line after line 5. 

Some commands take other information or parameters, stated after the 
command name. Examples might be option names in a set command, 
such as “set number”, a filename in an edit command, a regular 
expression in a substitute command, or a target address for a copy 
command. For example: 

1,5 copy 25 
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A number of commands have variants. The variant form of the com¬ 
mand is invoked by placing an exclamation mark (!) immediately after 
the command name. Some of the default variants may be controlled 
by options; in this case, the exclamation mark turns off the meaning of 
the default. 

In addition, many commands take flags, including the characters “p” 
and “1”. A “p” or “1” must be preceded by a blank or tab. In this 
case, the command abbreviated by these characters is executed after 
the command completes. Since ex normally displays the new current 
line after each change, p is rarely necessary. Any number of plus (+) 
or minus (-) characters may also be given with these flags. If they 
appear, the specified offset is applied to the current line value before 
the printing command is executed. 

Most commands that change the contents of the editor buffer give 
feedback if the scope of the change exceeds a threshold given by the 
report option. This feedback helps to detect undesirably large 
changes so that they may be quickly and easily reversed with the undo 
command. After commands with global effect, you will be informed if 
the net change in the number of lines in the buffer during this com¬ 
mand exceeds this threshold. 


Command Addressing 

The following specifies the line addressing syntax for ex commands: 

The current line. Most commands leave the current 
line as the last line which they affect. The default 
address for most commands is the current line, thus 
is rarely used alone as an address. 

The nth line in the editor’s buffer, lines being num¬ 
bered sequentially from 1. 

The last line in the buffer. 

An abbreviation for “1,$”, the entire buffer. 

An offset, n relative to the current buffer line. The 
forms “.+3” “+3” and “+++” are all equivalent. 
If the current line is line 100 they all address line 
103. 

Ipattern / or 1 pattern! 

Scan forward and backward respectively for a text 
matching the regular expression given by pattern. 
Scans normally wrap around the end of the buffer. 
If all that is desired is to print the next line contain¬ 
ing pattern, the trailing slash (/) or question mark 
(?) may be omitted. If pattern is omitted or 


n 

$ 

% 

+n or -n 
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explicitly empty, the string matching the last 
specified regular expression is located. The forms 
“RETURN” and “7RETURN” scan using the last 
named regular expression. After a substitute, 
“RETURN” and “??RETURN” would scan using 
that substitute’s regular expression. 

or x Before each nonrelative motion of the current line 

dot (.), the previous current line is marked with a 
label, subsequently referred to with two single quo¬ 
tation marks ("). This makes it easy to refer or 
return to this previous context. Marks are esta¬ 
blished with the vi m command, using a single 
lowercase letter as the name of the mark. Marked 
lines are later referred to with the following nota¬ 
tion: 

'x. 

where jc is the name of a mark. 

Addresses to commands consist of a series of addresses, separated by 
a colon (,) or a semicolon (;). Such address lists are evaluated left to 
right. When addresses are separated by a semicolon (;) the current 
line (.) is set to the value of the previous addressing expression before 
the next address is interpreted. If more addresses are given than the 
command requires, all but the last one or two are ignored. If the com¬ 
mand takes two addresses, the first addressed line must precede the 
second in the buffer. Null address specifications are permitted in a list 
of addresses, the default in this case is the current line thus 
,100 is equivalent to “.,100”. It is an error to give a prefix address 
to a command which expects none. 


Command Format 

The following is the format for all ex commands: 

[address] [command] [!] [parameters] [count] [flags] 

All parts are optional depending on the particular command and its 
options. The following section describes specific commands. 


Argument List Commands 

The argument list commands allow you to work on a set of files, by 
remembering the list of filenames that are specified when you invoke 
vi. The args command lets you examine this list of filenames. The 
file command gives you information about the current file. The n 
(next) command lets you either edit the next file 
in the argument list or change the list. And the rewind command lets 
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you restart editing the files in the list. All of these commands are 
described below: 

args The members of the argument list are displayed, with 

the current argument delimited by brackets. 

For example, a list might look like this: 

filel file2 [file3] file4 file5 
The current file is file3. 

f Displays the current filename, whether it has been 

modified since the last write command, whether it is 
read-only, the current linenumber, the number of 
lines in the buffer, and the percentage of the buffer 
that you have edited. In the rare case that the current 
file is “[Not edited]”, this is noted also; in this case 
you have to use w! to write to the file, since the edi¬ 
tor is not sure that a w command will not destroy a 
file unrelated to the current contents of the buffer. 

f file The current filename is changed to file which is con¬ 

sidered “[Not edited]”. 

n The next file in the command line argument list is 

edited. 

n! This variant suppresses warnings about the 

modifications to the buffer not having been written 
out, discarding irretrievably any changes that may 
have been made. 

n [ +command]filelist 

The specified filelist is expanded and the resulting 
list replaces the current argument list; the first file in 
the new list is then edited. If command is given (it 
must contain no spaces), then it is executed after 
editing the first such file. 

rew The argument list is rewound, and the first file in the 

list is edited. 

rew! Rewinds the argument list discarding any changes 

made to the current buffer. 

If you use C-Shell and set the prompt variable to output a prompt for 
non-interactive shells, the prompt is interpreted as a filename when 
you use these commands. This causes unexpected problems. To avoid 
these problems, use the default prompt value as specified m 
/usrlliblmkuser/mkuser.cshrc. 


March 15,1989 


VI-22 




VI (C) 


VI (C) 


Edit Commands 

To edit a file other than the one you are currently editing, you will 
often use one of the variations of the e command. 

In the following discussions, note that the name of the current file is 
always remembered by vi and is specified by a percent sign (%). The 
name of the previous file in the editing buffer is specified by a number 
sign (#). 

The edit commands are described below: 

efile Used to begin an editing session on a new file. The edi¬ 

tor first checks to see if the buffer has been modified 
since the last w command was issued. If it has been, a 
warning is issued and the command is aborted. The 
command otherwise deletes the entire contents of the 
editor buffer, makes the named file the current file, and 
displays the new filename. After ensuring that this file 
is sensible, (i.e., that it is not a binary file, directory, or 
a device), the editor reads the file into its buffer. If the 
read of the file completes without error, the number of 
lines and characters read is displayed on the status line. 
If there were any non-ASCII characters in the file, they 
are stripped of their non-ASCII high bits, and any null 
characters in the file are discarded. If none of these 
errors occurred, the file is considered edited. If the last 
line of the input file is missing the trailing newline 
character, it is supplied and a complaint issued. The 
current line is initially the first line of the file. 

el file This variant form suppresses the complaint about 

modifications having been made and not written from 
the editor buffer, thus discarding all changes that have 
been made before editing the new file. 

e +nfile Causes the editor to begin editing at line n rather than 
at the first line. The argument n may also be an editor 
command containing no spaces; for example, “+/pat- 
tem”. 

Ctrl-" This is a shorthand equivalent for “:e #RETURN”, 

which returns to the previous position in the last edited 
file. If you do not want to write the file, you should use 
“:e! #RETURN” instead. 


Write Commands 

The write commands let you write out all or part of your editing buffer 
to either the current file or to some other file. These commands are 
described below: 
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wfile Writes changes made back to file, displaying the 

number of lines and characters written. Normally, file 
is omitted and the buffer is written to the name of the 
current file. If file is specified, text is written to that 
file. The editor writes to a file only if it is the current 
file and is edited, or if the file does not exist. Other¬ 
wise, you must give the variant form w! to force the 
write. If the file does not exist it is created. The 
current filename is changed only if there is no current 
filename; the current line is never changed. 

If an error occurs while writing the current and edited 
file, the editor displays: 

No write since last change 

even if the buffer had not previously been modified. 

w »file Appends the buffer contents at the end of an existing 

file. Previous file contents are not destroyed. 

w! name Overrides the checking of the normal write command, 
and writes to any file that the system permits. 

w! command 

Writes the specified lines into command. Note the 
difference between 

w! file 

which overrides checks and 


w! cmd 

which writes to a command. The output of this com¬ 
mand is displayed on the screen and not inserted in the 
editing buffer. 


Read Commands 

The read commands let you read text into your editing buffer at any 
location you specify. The text you read in must be at least one line 
long, and can be either a file or the output from a command. 

r file Places a copy of the text of the given file in the editing 

buffer after the specified line. If no file is given, the 
current filename is used. The current filename is not 
changed unless there is none, in which case the file 
becomes the current name. If the file buffer is empty 
and there is no current name, this is treated as an e 
command. 
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Address 0 is legal for this command and causes the file 
to be read at the beginning of the buffer. Statistics are 
given as for the e command when the r successfully ter¬ 
minates. After an r the current line is the last line read. 

r ! command Reads the output of command into the buffer after the 
specified line. A blank or tab before the exclamation 
mark (!) is mandatory. 


Quit Commands 

There are several ways to exit vi. Some abort the editing session, 
some write out the editing buffer before exiting, and some warn you if 
you decide to exit without writing out the buffer. All of these ways of 
exiting are described below: 


q Exits vi. No automatic write of the editor buffer to a file 

is performed. However, vi displays a warning message if 
the file has changed since the last w command was issued, 
and does not quit, vi also displays a diagnostic if there are 
more files in the argument list left to edit. Normally, you 
will wish to save your changes, and you should enter a w 
command. If you wish to discard them, enter the q! com¬ 
mand variant. 


q! Quits from the editor, discarding changes to the buffer 

without complaint. 

wq name Like a w and then a q command. 

wq! name Overrides checking normally made before execution of 
the w command to any file. For example, if you own a file 
but do not have write permission turned on, the wq! 
allows you to update the file anyway. 

x name If any changes have been made and not written, writes the 

buffer out and then quits. Otherwise, it just quits. 


Global and Substitute Commands 

The global and substitute commands allow you to perform complex 
changes to a file in a single command. Learning how to use these 
commands is a must for an experienced vi user. 

g /pattern! cmds 

The g command has two distinct phases. In the first 
phase, each line matching pattern in the editing buffer is 
marked. Next, the given command list is executed with 
the current line, dot (.), initially set to each marked line. 
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The command list consists of the remaining commands on 
the current input line and may continue to multiple lines 
by ending all but the last such line with a backslash (\). 
This multiple-line option will not work from within yi, 
you must switch to ex to do it. If cmds (or the trailing 
slash (/) delimiter) is omitted, each line matching pattern 
is displayed. 

The g command itself may not appear in cmds. The 
options autoprint and autoindent are inhibited during a 
global command and the value of the report option is 
temporarily infinite, in deference to a report for the entire 
global. Finally, the context mark (') or (') is set to the 
value of the current line (.) before the global command 
begins and is not changed during a global command. 

The following global commands, most of them substitu¬ 
tions, cover the most frequent uses of the global com¬ 
mand. 


g/sl/p 

g/sl/s//s2/ 

g/sl/s//s2/g 

glsl/s//s2/gp 

g/slls//s2/gc 

g/s0/s/sl/s2/g 


This command simply prints all lines that contain 
the string “si” . 

This command substitutes the first occurrence of 
“si” on all lines that contain it with the string 
“s2”. 

This command substitutes all occurrences of “si” 
with the string “s2”. This includes multiple 
occurrences of “si” on a line. 

This command works the same as the preceding 
example, except that in addition, all changed lines 
are displayed on the screen. 

This command prompts you to confirm that you 
want to make each substitution of the string “si” 
with the string “s2”. If you enter a Y , the given 
substitution is made, otherwise it is not. 

This command marks all those lines that contain the 
string “sO”, and then for those lines only, substi¬ 
tutes all occurrences of the string “si” with “s2”. 


g [/pattern/cmds This variant form of g runs cmds at each line not 
matching pattern. 

gTM /g This command inserts blank spaces at the beginning 

of each line in a file. 
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s/patternlreplloptions 

On each specified line, the first instance of text 
matching the regular expression pattern is replaced 
by the replacement text repl. If the global indicator 
option character g appears, all instances on a line 
are substituted. If the confirm indication character 
c appears, before each substitution the line to be 
substituted is printed on the screen with the string 
to be substituted marked with caret ( A ) characters. 
By entering Y, you cause the substitution to be per¬ 
formed; any other input causes no change to take 
place. After an s command, the current line is the 
last line substituted. 

\/pattern! cmds A synonym for the global command variant g!, run¬ 

ning the specified cmds on each line that does not 
match pattern . 


Text Movement Commands 

The text movement commands are largely superseded by commands 
available in vi command mode. However, the following two com¬ 
mands are still quite useful: 

co addr flags A copy of the specified lines is placed after addr, 

which may be “0”. The current line addresses 
the last line of the copy. 

\range\maddr The m command moves the lines specified by range 
after the line given by addr. For example, m+ 
swaps the current line and the following line, since 
the default range is just the current line. The first of 
the moved lines becomes the current line (dot). 


Shell Escape Commands 

You will often want to escape from the editor to execute normal UNIX 
commands. You may also want to change your working directory so 
that your editing can be done with respect to a different working direc¬ 
tory. These operations are described below: 

cd directory The specified directory becomes the current direc¬ 
tory. If no directory is specified, the current value 
of the home option is used as the target directory. 
After a cd , the current file is not considered to have 
been edited so that write restrictions on preexisting 
files still apply. 
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sh A new shell is created. You may invoke as many 

commands as you like in this shell. To return to vi , 
enter a Ctrl-D to terminate the shell. 

'.command The remainder of the line after the exclamation (!) 

is sent to a shell to be executed. Within the text of 
command , the characters “%” and “#” are 
expanded as the filenames of the current file and the 
last edited file and the character “!” is replaced 
with the text of the previous command. Thus, in 
particular, “!!” repeats the last such shell escape. 
If any such expansion is performed, the expanded 
line is echoed. The current line is unchanged by 
this command. 

If there has been “[No write]” of the buffer contents since the last 
change to the editing buffer, a diagnostic is displayed before die com¬ 
mand is executed as a warning. A single exclamation (!) is displayed 
when the command completes. 

If you use C-Shell and set the prompt variable to output a prompt for 
non-interactive shells, the prompt is interpreted as an argument for 
command in shell escapes. This causes unexpected problems. To 
avoid these problems, use the default prompt value as specified in 
lusr/lib/mkuser/mkuser.cshrc. 


Other Commands 

The following command descriptions explain how to use miscellane¬ 
ous ex commands that do not fit into the above categories. 

The abbr, map, and set commands can also be defined with the 
EXINIT environment variable, which is read by the editor each time it 
starts up. For more information, see environ(M). Alternatively, these 
commands can be placed in a .exrc file in your home directory, which 
the editor reads if EXINIT is not defined. 

abbr Maps the first argument to the following string. For exam¬ 
ple, the following command 

:abbr rainbow yellow green blue red 

maps “rainbow” to “yellow green blue red”. Abbrevia¬ 
tions can be turned off with the unabbreviate command, 
as in: 

:una rainbow 

map, map! Maps any character or escape sequence to a command 
sequence. For example, the following command maps the 
CTRL-A key to a shell escape that runs the clear ( C) 
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command: 

map "A :!clear'M 

To include the CTRL-A and CTRL-M characters in the 
mapping, you must use vz’s CTRL-V escape. 

Characters mapped with map work in command mode, 
while characters mapped with map! work in insert mode. 
Characters mapped with map! cannot be unmapped using 

unmap. 

nu Displays each specified line preceded by its buffer line 

number. The current line is left at the last line displayed. 
To get automatic line numbering of lines in the buffer, set 
the number option. 

preserve The current editor buffer is saved as though the system 
had just crashed. This command is for use only in emer¬ 
gencies when a w command has resulted in an error and 
you do not know how to save your work. 

Displays the line number of the addressed line. The 
current line is unchanged. 


recover file 

Recovers file from the system save area. The system 
saves a copy of the editing buffer only if you have made 
changes to the file, the system crashes, or you execute a 
preserve command. When you use preserve , you are 
notified by mail when a file is saved. 

set argument 

With no arguments, set displays those options whose 
values have been changed from their defaults; with the 
argument all, it displays all of the option values. 

Giving an option name followed by a question mark (?) 
causes the current value of that option to be displayed. 
The question mark is unnecessary unless the option is a 
Boolean value. Switch options are given values either 
with: 


set option 
to turn them on or: 

set no option 

to turn them off. String and numeric options are assigned 
with: 
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set option=va\ue 

More than one option can be given to set ; all are inter¬ 
preted from left to right. See “Options” for a complete 
list and descriptions. 

tag label The focus of editing switches to the location of label. If 
necessary, vi will switch to a different file in the current 
directory to find label. If you have modified the current 
file before giving a tag command, you must first write it 
out. If you give another tag command with no argument, 
the previous label is used. 

Similarly, if you press Ctrl-], vi searches for the word 
immediately after the cursor as a tag. This is equivalent 
to entering “dag”, the word following the cursor, and 
then pressing the RETURN key. 

The tags file is normally created by a program such as 
rtags, and consists of a number of lines with three fields 
separated by blanks or tabs. The first field gives the name 
of the tag, the second the name of the file where the tag 
resides, and the third gives an addressing form which can 
be used by the editor to find the tag. This field is usually a 
contextual scan using / pattern / to be immune to minor 
changes in the file. Such scans are always performed as if 
the nomagic option was set. The tag names in the tags 
file must be sorted alphabetically. 

unmap Unmaps any character or escape sequence that has been 
mapped using the map command. 


Options 

There are a number of options that can be set to affect the vi environ¬ 
ment. These can be set with the ex set command while editing, with 
the EXINIT environment variable, or in the vi start-up file, .exrc. This 
file normally sets the user’s preferred options so that they do not need 
to be set manually each time you invoke vi. 

The first thing that must be done before you can use vi , is to set the 
terminal type so that vi understands how to talk to the particular termi¬ 
nal you are using. 

There are only two kinds of options: switch options and string options. 
A switch option is either on or off. A switch is turned off by prefixing 
the word no to the name of the switch within a set command. String 
options are strings of characters that are assigned values with the syn¬ 
tax option=string. Multiple options may be specified on a line, vi 
options are listed below: 
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autoindent, ai default: noai 

Can be used to ease the preparation of structured program text. For 
each line created by an append, change, insert, open, or substitute 
operation, vi looks at the preceding line to determine and insert an 
appropriate amount of indentation. To back the cursor up to the 
preceding tab stop, press Ctrl-D. The tab stops going backward are 
defined as multiples of the shiftwidth option. You cannot back¬ 
space over the indent, except by pressing Ctrl-D. 

Specially processed in this mode is a line with no characters added 
to it, which turns into a completely blank line (the whitespace pro¬ 
vided for the autoindent is discarded). Also, specially processed 
in this mode are lines beginning with a caret (*) and immediately 
followed by a Ctrl-D. This causes the input to be repositioned at 
the beginning of the line, but retains the previous indent for the 
next line. Similarly, a “0” followed by a Ctrl-D, repositions the 
cursor at the beginning without retaining the previous indent. 
Autoindent doesn’t happen in global commands. 

autoprint ap default: ap 

Causes the current line to be displayed after each ex copy, move, 
or substitute command. This has the same effect as supplying a 
trailing “p” to each such command. Autoprint is suppressed in 
globals, and only applies to the last command on a line. 

autowrite, aw default: noaw 

Causes the contents of the buffer to be automatically written to the 
current file if you have modified it when you give a next, rewind, 
tag, or ! command, or a Ctrl-* (switch files) or Ctrl-] (tag go to) 
command. 

beautify, bf default: nobeautify 

Causes all control characters except tab, newline and formfeed to 
be discarded from the input. A complaint is registered the first 
time a backspace character is discarded. Beautify does not apply 
to command input. 

directory, dir default: dir=/tmp 

Specifies the directory in which vi places the editing buffer file. If 
the directory does not have write permission, the editor will exit 
abruptly when it fails to write to the buffer file. 

edcompatible default: noedcompatible 

Causes the presence or absence of g and c suffixes on substitute 
commands to be remembered, and to be toggled on and off by 
repeating the suffixes. The suffix r causes the substitution to be like 
the tilde () command, instead of like the ampersand command 
(&). 

errorbells, eb default: noeb 

Error messages are preceded by a bell. If possible, the editor 
always places the error message in inverse video instead of ringing 
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the bell. 

hardtabs, ht default: ht=8 

Gives the boundaries on which terminal hardware tabs are set or on 
which tabs the system expands. 

ignorecase, ic default: noic 

Maps all uppercase characters in the text to lowercase in regular 
expression matching. In addition, all uppercase characters in regu¬ 
lar expressions are mapped to lowercase except in character class 
specifications enclosed in brackets. 

lisp default: nolisp 

Autoindent indents appropriately for LISP code, and the () { } [[ 
and ]] commands are modified to have meaning for LISP. 

list default: nolist 

All printed lines are displayed, showing tabs and end-of-lines. 
magic default: magic 

If nomagic is set, the number of regular expression metacharacters 
is greatly reduced, with only up-arrow Q and dollar sign ($) hav¬ 
ing special effects. In addition, the metacharacters and 
in replacement patterns are treated as normal characters. All the 
normal metacharacters may be made magic when nomagic is set 
by preceding them with a backslash (\). 

mesg default: nomesg 

Causes write permission to be turned off to the terminal while you 
are in visual mode, if nomesg is set. This prevents people writing 
to your screen with the UNIX write command and scrambling your 
screen as you edit. 

number, n default: nonumber 

Causes all output lines to be printed with their line numbers. 

open default: open 

If set to noopen, the commands open and visual are not permitted 
from ex. This is set to prevent confusion resulting from accidental 
entry to open or visual mode. 

optimize, opt default: optimize 

Output of text to the screen is expedited by setting the teiminal so 
that it does not perform automatic carriage returns when displaying 
more than one line of output, thus greatly speeding output on ter¬ 
minals without addressable cursors when text with leading whi¬ 
tespace is printed. 

paragraphs, para default: para =IPLPPPQPP TPbp 

Specifies paragraph delimiters for the { and } operations. The pairs 
of characters in the option’s value are the names of the nroff mac¬ 
ros that start paragraphs. 
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prompt default: prompt 

ex input is prompted for with a colon (:). If noprompt is set, when 
ex command mode is entered with the Q command, no colon 
prompt is displayed on the status line. 

redraw default: noredraw 

The editor simulates (using great amounts of output), an intelligent 
terminal on a dumb terminal. Useful only at very high speed. 

remap default: remap 

If on, mapped characters are repeatedly tried until they are 
unchanged. For example, if o is mapped to O and O is mapped to /, 
o will map to I if remap is set, and to O if noremap is set. 

report default: report=5 

Specifies a threshold for feedback from commands. Any command 
that modifies more than the specified number of lines will provide 
feedback as to the scope of its changes. For global commands and 
the undo command, the net change in the number of lines in the 
buffer is presented at the end of the command. Thus notification is 
suppressed during a g command on the individual commands per¬ 
formed. 

scroll default: scroll=!4 window 

Determines the number of logical lines scrolled when Ctrl-D is 
received from a terminal input in command mode, and the number 
of lines displayed by a command mode z command (double the 
value of scroll). 

sections default: sections=SHNHH HU 

Specifies the section macros for the [[ and ]] operations. The pairs 
of characters in the option’s value are the names of the nroff mac¬ 
ros that start paragraphs. 

shell, sh default: sh=/bin/sh 

Gives the pathname of the shell forked for the shell escape com¬ 
mand (!), and by the shell command. The default is taken from 
SHELL in the environment, if present. 

shiftwidth, sw default:sw=8 

Gives the width of a software tab stop, used in reverse tabbing with 
Ctrl-D when using autoindent to append text, and by the shift com¬ 
mands. 

showmatch, sm default: nosm 

When a ) or } is typed, moves the cursor to the matching ( or { for 
one second if this matching character is on the screen. 

showmode default: noshowmode 

Causes the message “INPUT MODE to appear on lower right 
comer of the screen when insert mode is activated. 
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slowopen default: noslowopen 

Postpones update of the display during inserts. 

tabstop, ts default: ts=8 

The editor expands tabs in the input file to be on n boundaries for 
the purposes of display. 

taglength, tl default: tl=0 

The first n characters in a tag name are significant, but all others 
are ignored. A value of zero (the default) means that all characters 
are significant. 

tags default: tags=tags /usr/lib/tags 

A path of files to be used as tag files for the tag command. A 
requested tag is searched for in the specified files, sequentially. By 
default, files named tag are searched for in the current directory 
and in /usr/lib. 

term default=value of shell TERM variable 
The terminal type of the output device. 

terse default: noterse 

Shorter error diagnostics are produced for the experienced user, 
timeout, to default: noto 

Eliminates the 1 second time limit for maps (character mappings), 
warn default: warn 

Warn if there has been “[No write since last change]” before a 
shell escape command (!). 

window default: window = speed dependent 

This specifies the number of lines in a text window. The default is 
8 at slow speeds (600 baud or less), 16 at medium speed (1200 
baud), and the full screen (minus one line) at higher speeds. 

w300, wl200, w9600 

These are not true options but set window (above) only if the 
speed is slow (300), medium (1200), or high (9600), respectively. 

wrapscan, ws default: ws 

Searches, using the regular expressions in addressing, will wrap 
around past the end of die file. 

wrapmargin, wm default: wm=0 

Defines the margin for automatic insertion of newlines during text 
input. A value of zero specifies no wrap margin. 

writeany, wa default: nowa 

Inhibits the checks normally made before write commands, allow¬ 
ing a write to any file that the system protection mechanism will 
allow. 
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A regular expression specifies a set of strings of characters. A 
member of this set of strings is said to be “matched” by the regular 
expression, vi remembers two previous regular expressions: the pre¬ 
vious regular expression used in a substitute command and the previ¬ 
ous regular expression used elsewhere, referred to as the previous 
scanning regular expression. The previous regular expression can 
always be referred to by a null regular expression: e.g., “//” or “??”. 

The regular expressions allowed by vi are constructed in one of two 
ways depending on the setting of the magic option. The ex and vi 
default setting of magic gives quick access to a powerful set of regu¬ 
lar expression metacharacters. The disadvantage of magic is that the 
user must remember that these metacharacters are magic and precede 
them with the backslash (\) to use them as “ordinary” characters. 
With nomagic set, regular expressions are much simpler, there being 
only two metacharacters. The power of the other metacharacters is 
still available by preceding the now ordinary character with a “\”. 
Note that ‘ ‘V ’ is always a metacharacter. In this discussion, the magic 
option is assumed. With nomagic , the only special characters are the 
caret Q at the beginning of a regular expression, the dollar sign ($) at 
the end of a regular expression, and the backslash (\). The tilde (~) 
and the ampersand (&) also lose their special meanings related to the 
replacement pattern of a substitute. 

The following basic constructs are used to construct magic mode reg¬ 
ular expressions. 

char An ordinary character matches itself. Ordinary characters are 
any characters except a caret ( A ) at the beginning of a line, a 
dollar sign ($) at the end of line, a star (*) as any character other 
than the first, and any of the following characters: 

• \[~ 

These characters must be preceded by a backslash (\) if they are 
to be treated as ordinary characters. 

At the beginning of a pattern, forces the match to succeed only 
at the beginning of a line. 

$ At the end of a regular expression, forces the match to succeed 
only at the end of the line. 

. Matches any single character except the newline character. 

\< Forces the match to occur only at the beginning of a “word”; 
that is, either at the beginning of a line, or just before a letter, 
digit, or underline and after a character not one of these. 
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\> Similar to ‘V”, but matching the end of a “word”, i.e., either 
the end of the line or before a character which is not a letter, a 
digit, or the underline character. 

[string] j 

Matches any single character in the class denned by string. 
Most characters in string define themselves. A pair of charac¬ 
ters separated by a dash (-) in string defines the set of characters 
between the specified lower and upper bounds, thus ‘ [a-z] as a 
regular expression matches any single lowercase letter. If the 
first character of string is a caret ( A ) then the construct matches 
those characters which it otherwise would not. Thus ‘Ta-z]” 
matches anything but a lowercase letter or a newline. To place 
any of the characters caret, left bracket, or dash in string they 
must be escaped with a preceding backslash (\). 

The concatenation of two regular expressions first matches the left¬ 
most regular expression and then the longest string that can be recog¬ 
nized as a regular expression. The first part of this new regular 
expression matches the first regular expression and the second part 
matches the second. Any of the single character matching regular 
expressions mentioned above may be followed by a star () to form a 
regular expression that matches zero or more adjacent occurrences of 
the characters matched by the prefixing regular expression. The tilde 
O may be used in a regular expression to match the text that defined 
the replacement part of the last s command. A regular expression may 
be enclosed between the sequences and “\)” to remember the 
text matched by the enclosed regular expression. This text can later 
be interpolated into the replacement text using the following notation: 

\ digit 

where digit enumerates the set of remembered regular expressions. 

The basic metacharacters for the replacement pattern are the amper¬ 
sand (&) and the tilde ("); these are given as “\&” and ‘V” when 
nomagic is set. Each instance of the ampersand is replaced by the 
characters matched by the regular expression. In the replacement pat¬ 
tern, the tilde stands for the text of the previous replacement pattern. 

Other metasequences possible in the replacement pattern are always 
introduced by a backslash (\). The sequence “\n” is replaced by the 
text matched by the nth regular subexpression enclosed between “\(” 
and “\)’\ When nested, parenthesized subexpressions are present, n 
is determined by counting occurrences of “\(” starting from the left. 
The sequences “\u” and “\1” cause the immediately following char¬ 
acter in the replacement to be converted to uppercase or lowercase, 
respectively, if this character is a letter. The sequences “\U” and 
“\L” mm such conversion on, either until “\E” or “\e” is encoun¬ 
tered, or until the end of the replacement pattern. 
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Files 


/tmp 

default directory where temporary work 
files are placed; it can be changed using 
the directory option (see the ex(C) set 
command.). 

/usr/lib/terminfo/? /* 

compiled terminal description database 

/usr/lib/.COREterm/?/* 

subset of compiled terminal description 
database 

Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 

Notes 



The /usr/Iib/ex3.7preserve program can be used to restore vi buffer 
files that were lost as a result of a system crash. The program searches 
the /tmp directory for vi buffer files and places them in the directory 
/usr/preserve. The owner can retrieve these files using the -r option. 

The /usr/lib/ex3.7preserve program must be placed in the system 
startup file, /etc/rc.d/3/recovery, before the command that cleans out 
the /tmp directory. See the System Administrator s Guide for more in¬ 
formation on the /etc/rc2 scripts. 

Two options, although they continue to be supported, have been re¬ 
placed in the documentation by the options that follow the Command 
Syntax Standard (see intro ( C)). A -r option that is not followed with 
an argument has been replaced by -L and +command has been re¬ 
placed by -c command. 

vi does not strip the high bit from 8 bit characters read in from text 
files, text insertion, and editing commands. It does not look for magic 
numbers of object files when reading in a text file. It also writes out 
text and displays text without stripping the high bit. 

vi uses the LCCTYPE environment variable to determine if a char¬ 
acter is printable, displaying the octal codes of non-printable 8 bit 
characters. It also uses LC CTYPE and LANG to convert between 
upper and lowercase characters for the tilde command and for the ig- 
norecase option. 
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When the percent sign (%) is used in a shell escape from vi via the 
exclamation mark (!) the % is replaced with the name of the file being 
edited. In previous versions of vi , each character in this replacement 
had the high bit set to 1 to quote it; in the current version of vi it is left 
alone. 

Warnings 

Tampering with the entries in /usr/lib/.COREterm/?/* or 
/usr/iib/terminfo/?/* (for example, changing or removing an entry) 
can affect programs such as vi that expect all entries to be present and 
correct. In particular, removing the “dumb” terminal entry may 
cause unexpected problems. 

Software tabs using A T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals do not make use of insert 
and delete operations in the terminal. 

Refer to the crypt(C) page for information about restrictions on the 
availability of encryption options. 

Standards Conformance 


vedit and view are conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 

vi is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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vidi 

sets the font and video mode for a video device 


Syntax 


vidi [ -d ] [ -f fontfile ] command 

Description 


vidi sets video mode or loads/extracts a font from the device that is the 
current standard input; without arguments, it lists the all of the valid 
video mode and font commands. 

Some video cards support changeable character fonts. The vidi font 
commands (font8x8, font8xl4, and font8xl6) are used to load and 
extract fonts from the tables stored in the kernel. If neither of the -d 
or -f options has been specified, vidi will attempt to load the specified 
font from i/usr/lib/ \idiifontname. he -d option causes vidi to read the 
specified font from the kernel and write (dump) the font to the stan¬ 
dard output. 

The -f option is used to load fonts other than those in /usr/lib/vidi or to 
specify an output file other than standard output. When loading a font, 
-f filename will load the font from filename instead of from 
/usr/lib/vidi#' ontname. When extracting a font (-d option) 4filename 
causes vidi to write the extracted font into filename instead of writing 
the font to the standard output. 

The other vidi commands set the video mode of the video adapter con¬ 
nected to vidi 9 s standard input. The commands are : 

mono 

move current screen to the monochrome adapter, 
cga 

move current screen to the Color Graphics adapter, 
ega 

move current screen to the Enhanced Graphics adapter, 
vga 

move current screen to the Video Graphics adapter, 
internal 

activate the internal monitor on portable with a plasma screen. 

external 

activate the external monitor on portable with a plasma screen. 
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Text Modes 

Command 

Cols 

Rows 

Font 

Adapter 

c40x25 

40 

25 

8x8 

CGA (EGA VGA) 

e40x25 

40 

25 

8x14 

EGA (VGA) 

v40x25 

40 

25 

8x16 

VGA 

m80x25 

80 

25 

8x14 

MONO (EGA_MONO VGA_MONO) 

c80x25 

80 

25 

8x8 

CGA (EGA VGA) 

em80x25 

80 

25 

8x14 

EGA MONO (VGA_MONO) 

e80x25 

80 

25 

8x14 

EGA (VGA) 

vm80x25 

80 

25 

8x16 

VGA MONO 

v80x25 

80 

25 

8x16 

VGA 

e80x43 

80 

43 

8x14 

EGA (VGA) 


Graphics Modes 

Command 

Pixel Resolution 

Colors 

mode5 

320x200 

4 

mode6 

640x200 

2 

modeD 

320x200 

16 

modeE 

640x200 

16 

modeF 

640x350 

2 (mono) 

mode 10 

640x350 

16 

model 1 

640x480 

2 

mode 12 

640x480 

16 

mode 13 

320x200 

256 


See Also 


screen(HW) 


Notes 


The internal and external commands do not work with 
all types of portables. 
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vmstat _ 

report paging and system statistics 

Syntax 

vmstat [ -fs ] [ -n namelist ] [ -I lines ] [ interval [ count ]] 

Description 


vmstat reports some statistics kept by the system on processes, 
demand paging, and cpu and trap activity. Three types of reports are 
available: 

(default) 

A summary of the number of processes in various states, paging 
activity, system activity, and cpu cycle consumption. 

-f Number of fork(SYs done. 

-s A verbose listing of paging and trap activity. 

If no interval or count is specified, the totals since system bootup are 
displayed. 

If an interval is given, the number of events that have occurred in the 
last interval seconds is shown. If no count is specified, this display is 
repeated forever every interval seconds. Otherwise, when a count is 
also specified, the information is displayed count times. 

Other flags that may be specified include: 

-n namelist 

Use file namelist as an alternate symbol table instead of /unix. 

-1 lines 

For the default display, repeat the header every lines reports 
(default is 20). 

The fields in the default report are: 

procs 

The number of processes which are: 
r In the run queue, 
b Blocked waiting for resources. 
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w Swapped out. 

These values always reflect the current situation, even if the totals 
since boot are being displayed. 

paging 

Reports on the performance of the demand paging system. Unless 
the totals since boot are being displayed, this information is aver¬ 
aged over the proceeding interval seconds: 

frs Free swap space. 

dmd 

Demand zero and demand fill pages, 
sw Pages on swap, 
cch 

Pages in cache, 
fil Pages on file, 
pft 

Protection faults. 


frp 

Pages freed. 

pos 

Processes swapped out successfully. 


pif 

Processes swapped out unsuccessfully. 


rso 

Regions swapped out. 
rsi Regions swapped in. 
system 

Reports on the general system activity. Unless the totals since 
boot are being shown, these figures are averaged over the last 
interval seconds: 

sy Number of system calls. 

cs Number of context switches. 

cpu 

Percentage of cpu cycles spent in various operating modes: 
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us User, 
su System, 
id Idle. 

This information may not be displayed on some systems. 

The -f and -s reports are a series of lines of the form: 
number description 

which means that number of the items described by description hap¬ 
pened (either since boot or in the last interval seconds, as appropri¬ 
ate). These reports should be self-explanatory. 

Files 


/unix 

Default namelist, 
/dev/kmem 

Default source of statistics. 

See Also 

fork(S), ps(C), pstat(C) 

Authorization 


The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the command will not work. Refer 
to the Using a Trusted System’ ’ chapter of the User’s Guide for more 
details. 
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W__ 

displays information about who is on the system and 

what they are doing 

Syntax 

w [-hlqtw] [-n namelist] [-s swapdev] [-u utmpfile] [users...] 


Description 

w prints a summary of the current activity on the system, including 
what each user is doing. The heading line shows the current time of 
day, how long the system has been up, and the number of users logged 
onto the system. On systems that maintain the necessary data, the 
heading line also shows load averages. Load averages are the number 
of processes in the run queue averaged over 1,5, and 15 minutes. 

The options are: 

-h Don’t print the heading or title lines. 


Long format (default): For each user, w outputs the user’s login 
name, the terminal or pseudo terminal the user is currently using, 
when the user logged onto the system, the number of minutes the 
user has been idle (how much time has expired since the user last 
typed anything), the CPU time used by all processes and their chil¬ 
dren attached to the terminal, the CPU time used by the currently 
active process, and the name and arguments of the currently active 
process. 

-q Quick format: For each user, w outputs the user’s login name, the 
terminal or pseudo terminal the user is currently using, the number 
of minutes the user has been idle, and the name of the currently 
active process. 


Only the heading line is output (equivalent to uptime(C)). 
-w Both the heading line and the summary of users is output, 
-n namelist 

The argument is taken as the name of an alternate namelist 
(/unix is the default). 


-s swapdev , , _. . . . , 

Uses the file swapdev in place of /dev/swap. This is useful when 

examining a corefile. 
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-uutmpfile 

The file utmpfile is used instead of letclutmp as a record of who is 
currently logged in. 

If any users are given, the user summary is restricted to reporting on 
those users. 

Files 


/unix 

/etc/utmp 

/dev/kmem 

/dev/swap 

See Also 


date(C), finger(C), ps(C), uptime(C), who(C), whodo(C) 

Notes 


The “currently active process” is only an approximation and is not 
always correct. Pipelines can produce strange results, as can some 
background processes. If w is completely unable to guess at the 
currently active process, it prints 

Authorization 


The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the “Using a Trusted Sys¬ 
tem” chapter of the User’s Guide for more details. 
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wait __ 

awaits completion of background processes 

Syntax 

wait 

Description 

Waits until all background processes started with an ampersand (&) 
have finished, and reports on abnormal terminations. 

wait is built in to csh and sh. 

( 

Because the wait{ S) system call must be executed in the parent pro¬ 
cess, the shell itself executes wait, without creating a new process. 

See Also 


csh(C), sh(C) 

Notes 


Not all the processes of a pipeline with three or more stages are chil¬ 
dren of the shell, and thus cannot be waited for. 

Standards Conformance 


wait is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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WC _ 

counts lines, words and characters 

Syntax 

wc [ -lwc ] [ names ] 

Description 


wc counts lines, words and characters in the named files, or in the 
standard input if no names appear. It also keeps a total count for all 
named files. A word is a maximal string of characters delimited by 
spaces, tabs, or newlines. 

The options 1, w, and c may be used in any combination to specify that 
a subset of lines, words, and characters are to be reported. The default 
is -lwc. 

When names are specified on the command line, they are printed 
along with the counts. 

Standards Conformance 


wc is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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what 


identifies files 


Syntax 

what files 

Description 

what searches the given files for all occurrences of the pattern @(#) 
and prints out what follows until the first tilde (~), greater-than sign 
(>), new-line, backslash (\) or null character. The SCCS command 
get (CP) substitutes this string as part of the @(#) string. 

For example, if the shell procedure in file print contains 

# @ (#)this is the print program 

# @(#)syntax: print [files] 
pr $* | lpr 

then the command 

what print 

displays the name of the file print and the identifying strings in that 
file: 

print: 

this is the print program 
syntax: print [files] 

what is intended to be used with the get (CP) command, which 
automatically inserts identifying information, but it can also be used 
where the information is inserted manually. 

See Also 


admin(CP), get(CP) 

Standards Conformance 


what is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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who 


lists who is on the system 

Syntax 


who [ -uATHldtasqbrp ] [ file ] 
who am i 
who am I 

Description 


who can list the user’s name, terminal line, login time, and the elapsed 
time since activity occurred on the line; it also lists the process ID of 
the command interpreter (shell) for each current user. It examines the 
/tcb/files/inittab file to obtain information for the Comments column, 
and /etc/utmp to obtain all other information. If file is given, that file 
is examined. Usually, file will be /etc/wtmp, which contains a history 
of all the logins since die file was last created. 

who with the am i or am I option identifies the invoking user. 

Except for the default -s option, the general format for output entries 
is: 


name [state] line time activity pid [comment] [exit] 

With options, who can list logins, logoffs, reboots, and changes to the 

system clock, as well as other processes spawned by the init process. 

These options are: 

-u This option lists only those users who are currently logged in. 
The name is the user’s login name. The line is the name of the 
line as found in the directory /dev. The time is the time that 
the user logged in. The activity is the number of hours and 
minutes since activity last occurred on that particular line. A 
dot (.) indicates that the terminal has seen activity in the last 
minute and is therefore “current”. If more than twenty-four 
hours have elapsed or the line has not been used since boot 
time, the entry is marked old. This field is useful when trying 
to determine whether a person is working at the terminal or 
not. The pid is the process ID of the user’s shell. The comment 
is the comment field. It can contain information about where 
the terminal is located, the telephone number of the dataset, 
the type of terminal if hard-wired, etc. 
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WHO (C) 


-A This option displays UNIX accounting information. 

-T This option is the same as the -u option, except that the state of 
the terminal line is printed. The state describes whether some¬ 
one else can write to that terminal. A plus character (+) 
appears if the terminal is writable by anyone; a minus charac¬ 
ter (-) appears if it is not. Root can write to all lines having a 
plus character (+) or a minus character (-) in the state field. If 
a bad line is encountered, a question mark (?) is displayed. 

-1 This option lists only those lines on which the system is wait¬ 
ing for someone to login. The name field is LOGIN in such 
cases. Other fields are the same as for user entries except that 
the state field does not exist. 

-H This option displays column headings above the regular output. 

-q This is a quick who, displaying only the names and the number 
of users currently logged on. When this option is used, all 
other options are ignored. 

-d This option displays all processes that have expired and have 
not been respawned by init. The exit field appears for dead 
processes and contains the termination and exit values (as 
returned by wait( S)), of the dead process. This can be useful in 
determining why a process terminated. 

-t This option indicates the last change to the system clock (via 
the date(C) command) by root. See su(C). 

-a This option processes the /etc/utmp file or the named file with 
all options turned on. 

-s This option is the default and lists only the name, line, and 
time fields. 

-p This option lists any other process which is currently active 
and has been previously spawned by init . The name field is the 
name of the program executed by init as found in 
/tcb/files/inittab. The state, line, and idle fields have no 
meaning. The comment field shows the id field of the line from 
/tcb/files/inittab that spawned this process. See inittab{ F). 

-b This option indicates the time and date of the last reboot. 

-r This option indicates the current run-level of the init process. 
In addition, it produces the process termination status, process 
id, and process exit status [see utmp (F)] under the idle , pid, 
and comment headings, respectively. 
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Files 


WHO (C) 


/etc/utmp 

/etc/wtmp 

/tcb/files/inittab 

See Also 


date(C), login(M), mesg(C), su(C), utmp(F), inittab(F), wait(S) 

Standards Conformance 


who is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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whodo__ 

determines who is doing what 

Syntax 

/etc/whodo 

Description 

whodo produces merged, reformatted, and dated output from the 
who(C) and ps(C) commands. 

See Also 

ps(C), who(C) 

Authorization 

The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the “Using a Trusted Sys¬ 
tem” chapter of the User’s Guide for more details. 


Standards Conformance 


whodo is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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write _ 

writes to another user 

Syntax 

write user [ tty ] 

Description 


write copies lines from your terminal to that of another user. When 
first called, it sends the message: 

Message from your-logname your-tty . . . 

The recipient of the message should write back at this point. Com¬ 
munication continues until an end-of-file is read from the terminal or 
an interrupt is sent. At that point, write displays: 


(end of message) 

on the other terminal and exits. 

If you want to write to a user who is logged in more than once, the tty 
argument may be used to indicate the appropriate terminal. 

Permission to write may be denied or granted by use of the mesg(C) 
command. At the outset, writing is allowed. Certain commands, in 
particular nroff( CT) and pr( C), disallow messages in order to prevent 
messy output. 

If the character ! is found at the beginning of a line, write calls the 
shell to execute the rest of the line as a command. 

The following protocol is suggested for using write : when you first 
write to another user, wait for him or her to write back before starting 
to send. Each party should end each message with a distinctive signal 
((o) for “over” is conventional), indicating that the other may reply; 
(oo) for “over and out” is suggested when conversation is to be ter¬ 
minated. 

Files 


/etc/utmp To find user 

/bin/sh To execute ! 
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See Also 


WRITE (C) 


mail(C), mesg(C), who(C) 

Standards Conformance 


write is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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X286EMUL (C) 


x 286 emul 

emulate XENIX 80286 

Syntax 


x286emul [ arg... ] prog286 

Description 


x286emul is an emulator that allows programs from XENIX 
System V/286 Release 2.3 or XENIX System V/286 Release 2.3.2 on 
the Intel 80286 to run on the Intel 80386 processor under UNIX 
System V Release 3.2 or later. 

The UNIX system recognizes an attempt to exec(S) a 286 program, 
and automatically exec ’s the 286 emulator with the 286 program name 
as an additional argument. It is not necessary to specify the x286emul 
emulator on the command line. The 286 programs can be invoked 
using the same command format as on the XENIX System V/286. 

x286emul reads the 286 program’s text and data into memory and 
maps them through the LDT (via sysi86( S)) as 286 text and data seg¬ 
ments. It also fills in the jam area, which is used by XENIX programs 
to do system calls and signal returns. x286emul starts the 286 program 
by jumping to its entry point. 

When the 286 program attempts to do a system call, x286emul takes 
control. It does any conversions needed between the 286 system call 
and the equivalent 386 system call, and performs the 386 system call. 
The results are converted to the form the 286 program expects, and the 
286 program is resumed. 

The following are some of the differences between a program running 
on a 286 and a 286 program using x286emul on a 386: 

Attempts to unlink or write on the 286 program will fail on the 286 
with ETXTBS Y. Under x286emul , they will not fail. 

ptrace (S) is not supported under x286emul. 

The 286 program must be readable for the emulator to read it. 
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X286EMUL (C) 


Files 


/bin/x286emul 

The emulator must have this name and be in /bin if it is to be 
automatically invoked when exec (S) is used on a 286 program. 
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xargs _ 

constructs and executes commands 

Syntax 


xargs [ flags ] [ command [ initial-arguments ] ] 

Description 


xargs combines the fixed initial-arguments with arguments read from 
the standard input to execute the specified cotumand one or more 
times. The number of arguments read for each command invocation 
and the manner in which they are combined are determined by the 
flags specified. 

Command , which may be a shell file, is searched for using the shell 
$PATH variable. If command is omitted, /bin/echo is used. 

Arguments read in from standard input are defined to be contiguous 
strings of characters delimited by one or more blanks, tabs, or new¬ 
lines; empty lines are always discarded. Blanks and tabs may be 
embedded as part of an argument if escaped or quoted: Characters 
enclosed in quotes (single or double) are taken literally, and the del¬ 
imiting quotes are removed. Outside of quoted strings, a backslash (\) 
will escape the next character. 

Each argument list is constructed starting with the initial-arguments , 
followed by some number of arguments read from standard input 
(exception: see -i flag). Flags -i, -1, and -n determine how arguments 
are selected for each command invocation. When none of these flags 
are coded, the initial-arguments are followed by arguments read con¬ 
tinuously from standard input until an internal buffer is full, and com¬ 
mand is executed with the accumulated args. This process is repeated 
until there are no more args. When there are flag conflicts (e.g., -1 vs. 
-n), the last flag has precedence. Flag values are: 

-1 number Command is executed for each number lines of 
nonempty arguments from the standard input. This is 
instead of the default single line of input for each com¬ 
mand. The last invocation of command will be with 
fewer lines of arguments if fewer than number remain. 
A line is considered to end with the first newline unless 
the last character of the line is a blank or a tab; a trail¬ 
ing blank/tab signals continuation through the next 
nonempty line. If number is omitted, 1 is assumed. 
Option -x is forced. 
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•i replstr 


■nnumber 


-t 


P 


■x 


-s size 


-eeofstr 


Insert mode: command is executed for each line from 
the standard input, taking the entire line as a single arg, 
inserting it in initial-arguments for each occurrence of 
replstr. A maximum of 5 arguments in initial- 
arguments may each contain one or more instances of 
replstr. Blanks and tabs at the beginning of each line 
are thrown away. Constructed arguments may not grow 
larger than 255 characters, and option -x is also forced. 

{ } is assumed for replstr if not specified. 

Executes command , using as many standard input 
arguments as possible, up to the number of arguments 
maximum. Fewer arguments are used if their total size 
is greater than size characters, and for the last invoca¬ 
tion if there are fewer than number arguments remain¬ 
ing. If option -x is also coded, each number of argu¬ 
ments must fit in the size limitation, or xargs ter¬ 
minates execution. 

Trace mode: The command and each constructed argu¬ 
ment list are echoed to file descriptor 2 just prior to 
their execution. 

Prompt mode: The user is prompted whether to execute 
command at each invocation. Trace mode (-t) is turned 
on to display the command instance to be executed, fol¬ 
lowed by a ?... prompt. A reply of y (optionally fol¬ 
lowed by anything), will execute the command; any¬ 
thing else, including a carriage return, skips that partic¬ 
ular invocation of command. 

Causes xargs to terminate if any argument list would 
be greater than size characters; -x is forced by the 
options -i and -1. When neither of the options -i, -1, or 
-n are coded, the total length of all arguments must be 
within the size limit. 

The maximum total size of each argument list is set to 
size characters; size must be a positive integer less than 
or equal to 470. If -s is not coded, 470 is taken as the 
default. Note that the character count for size includes 
one extra character for each argument and the count of 
characters in the command name. 

Eofstr is taken as the logical end-of-file string. Under¬ 
score (_) is assumed for the logical EOF string if -e is 
not coded, -e with no eofstr coded turns off the logical 
EOF string capability (underscore is taken literally). 
xargs reads standard input until either end-of-file or the 
logical EOF string is encountered. 
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xargs terminates if it either receives a return code of -1 from, or if it 
cannot execute, command. When command is a shell program, it 
should explicitly exit (see sh (C)) with an appropriate value to avoid 
accidentally returning with -1. 

Examples 


The following will move all files from directory $1 to directory $2, 
and echo each move command just before doing it: 

Is $1 I xargs -i -t mv $l/{ } $2/{ } 

The following will combine the output of the parenthesized com¬ 
mands onto one line, which is then echoed to the end of file log: 

(logname; date; echo $0 $*) I xargs »log 

The user is prompted to enter which files in the current directory are to 
be printed and prints them one at a time: 

Is I xargs -p -1 lpr 

Or many at a time: 

Is I xargs -p -1 I xargs lpr 

The following will execute diff(C) with successive pairs of arguments 
originally entered as shell arguments: 

echo $* I xargs -n2 diff 

Standards Conformance 


xargs is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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xtod _ 

change file format from UNIX to MS-DOS 

Syntax 

xtod [filename] > [output.file] 

Description 


The xtod command converts a file from UNIX format to MS-DOS for¬ 
mat. The MS-DOS files terminate a line of text with a carriage return 
and a linefeed, while UNIX files terminate a line with a linefeed only. 
Also MS-DOS places a (CTL)z at the end of a file, while UNIX does 
not. Some programs and utilities are sensitive to this difference and 
some are not. If a text or data file is not being interpreted correctly, 
use the dtox and xtod conversion utilities. The xtod command adds 
the extra carriage return to the end of each line and adds the (CTL)z to 
the end of the file. This utility is not required for converting binary 
object files. 

If no filename is specified on the command line, xtod takes input from 
standard input. Output of the utility goes to standard output. 

See Also 


dtox(C) 
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YES (C) 


yes _ 

prints string repeatedly 

Syntax 

yes [ string ] 

Description 


yes repeatedly outputs “y”, or if a single string argument is given, arg 
is output repeatedly. The command will continue indefinitely unless 
aborted. Useful in pipes to commands that prompt for input and 
require a “y” response for a yes. In this case, yes terminates when 
the command it pipes to terminates, so that no infinite loop occurs. 
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rmb 

remove extra blank lines from a file 
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list of supported terminals 
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termios 
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tz 
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Intro _ 

introduction to miscellaneous features and files 

Description 


This section contains miscellaneous information useful in mainlining 
the system. Included are descriptions of files, devices, tables and pro¬ 
grams that are important in maintaining the entire system. 
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ascii _ 

map of the ASCII character set 

Description 


ascii is a map of the 7-bit ASCII character set. It lists both octal and 
hexadecimal equivalents of each character. It contains: 



Hexadecimal 

00 

nul 

01 

soh 

02 

stx 

03 

etx 

04 

eot 

05 

enq 

06 

ack 

07 

bel 

08 

bs 

09 

ht 

0a 

nl 

0b 

vt 

0c 

np 

Od 

cr 

Oe 

so 

Of 

si 

10 

die 

11 

del 

12 

dc2 

13 

dc3 

14 

dc4 

15 

nak 

16 

syn 

17 

etb 

18 

can 

19 

em 

la 

sub 

lb 

esc 

lc 

fs 

Id 

gs 

le 

rs 

If 

us 

20 

sp 

21 

f 

22 

" 

23 

# 

24 

$ 

25 

% 

26 

& 

27 

✓ 

28 

( 

29 

) 

2a 

* 

2b 

+ 

2c 


2d 

- 

2e 

# 

2f 

/ 

30 

0 

31 

1 

32 

2 

33 

3 

34 

4 

35 

5 

36 

6 

37 

7 

38 

8 

39 

9 

3a 


3b 

; 

3c 

< 

3d 

= 

3e 

> 

3f 

9 

40 

@ 

41 

A 

42 

B 

43 

C 

44 

D 

45 

E 

46 

F 

47 

G 

48 

H 

49 

I 

4a 

J 

4b 

K 

4c 

L 

4d 

M 

4e 

N 

4f 

O 

50 

P 

51 

Q 

52 

R 

53 

S 

54 

T 

55 

U 

56 

V 

57 

W 

58 

X 

59 

Y 

5a 

Z 

5b 

[ 

5c 

\ 

5d 

] 

5e 

- 

5f 


60 

X 

61 

a 

62 

b 

63 

c 

64 

d 

65 

e 

66 

f 

67 

g 

68 

h 

69 

i 

6a 

j 

6b 

k 

6c 

1 

6d 

m 

6e 

n 

6f 

0 

70 

P 

71 

q 

72 

r 

73 

s 

74 

t 

75 

u 

76 

V 

77 

w 

78 

X 

79 

y 

7a 

z 

7b 

{ 

7c 

1 

7d 

} 

7e 

~ 

7f 

del 
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The extended 8-bit ASCII character set is shown here, again with the 
octal and hexadecimal value of each character. The mapchan(C) util¬ 
ity allows access to these characters. Display of these characters is 
dependent on the capabilities of the hardware device. (A indicates 
an unassigned character.) 



Octal 

200 38 

201 38 

202 38 

203 38 

204 ind 

205 nel 

206 ssa 

207 esa 

210 hts 

211 htj 

212 vts 

213 pld 

214 plu 

215 ri 

216 ss2 

217 ss3 

220 dcs 

221 pul 

222 pu2 

223 sts 

224 cch 

225 mw 

226 spa 

227 epa 

230 & 

231 38 

232 & 

233 csi 

234 st 

235 osc 

236 pm 

237 ape 

240 nbsp 

241 i 

242 0 

243 £ 

244 □ 

245 ¥ 

246 1 

247 § 

250 " 

251 © 

252 8 

253 « 

254 

255 shy 

256 ® 

257 

260 ° 

261 ± 

262 2 

263 3 

264 ' 

265 \i 

266 H 

267 • 

270 , 

271 1 

272 0 

273 » 

274 !4 

275 'A 

276 Va 

277 i 

300 A 

301 A 

302 A 

303 A 

304 A 

305 A 

306 JE 

307 g 

310 £ 

311 £ 

312 £ 

313 E 

314 I 

315 1 

316 t 

317 1 

320 D 

321 N 

322 6 

323 6 

324 6 

325 O 

326 6 

327 & 

330 0 

331 U 

332 U 

333 U 

334 U 

335 Y 

336 I> 

337 6 

340 b 

341 a 

342 a 

343 a 

344 a 

345 ae 

346 ae 

347 5 

350 b 

351 € 

352 e 

353 e 

354 1 

355 i 

356 i 

357 l 

360 d 

361 n 

362 6 

363 6 

364 6 

365 6 

366 6 

367 & 

370 0 

371 u 

372 u 

373 u 

374 u 

375 y 

376 {> 

377 y 


Hexadecimal 

80 

m 

81 

m 

82 


83 


84 

ind 

85 

nel 

86 

ssa 

87 

esa 

88 

hts 

89 

htj 

8a 

vts 

8b 

pld 

8c 

plu 

8d 

ri 

8e 

ss2 

8f 

ss3 

90 

dcs 

91 

pul 

92 

pu2 

93 

sts 

94 

cch 

95 

mw 

96 

spa 

97 

epa 

98 

& 

99 

& 

9a 

38 

9b 

csi 

9c 

st 

9d 

osc 

9e 

pm 

9f 

ape 

aO 

nbsp 

al 

i 

a2 

0 

a3 

£ 

a4 

a 

a5 

¥ 

a6 

1 

a7 

§ 

a8 

- 

a9 

© 

aa 

a 

ab 

« 

ac 

— i 

ad 

shy 

ae 

® 

af 


bO 

o 

bl 

± 

b2 

2 

b3 

3 

b4 

' 

b5 


b6 

1 

b7 


b8 


b9 

i 

ba 

s 

bb 

» 

be 

'A 

bd 

A 

be 

3 /4 

bf 

i 

cO 

A 

cl 

A 

c2 

A 

c3 

A 

c4 

A 

c5 

A 

c6 

JE 

c7 

C 

c8 

£ 

c9 

£ 

ca 

e 

cb 

E 

cc 

i 

cd 

f 

ce 

I 

cf 

i 

dO 

D 

dl 

N 

d2 

6 

d3 

6 

d4 

6 

d5 

0 

d6 

6 

d7 

& 

d8 

0 

d9 

U 

da 

u 

db 

u 

dc 

u 

dd 

Y 

de 

p 

df 

6 

eO 

a 

el 

a 

e2 

a 

e3 

a 

e4 

a 

e5 

a 

e6 

ae 

e7 

9 

e8 

b 

e9 

6 

ea 

e 

eb 

e 

ec 

i 

ed 

i 

ee 

i 

ef 

i' 

fO 

d 

fl 

n 

f2 

6 

f3 

6 

f4 

6 

f5 

6 

f6 

6 

f7 

38 

f8 

0 

f9 

u 

fa 

u 

fb 

u 

fc 

u 

fd 

y 

fe 


ff 

y 



Files 


/usr/pub/ascii 
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chrtbl _ 

create a ctype locale table 

Syntax 


chrtbl [ specfile ] 

Description 


The utility chrtbl is provided to allow new LC.CTYPE locales to be 
defined; It reads a specification file, containing definitions of the attri¬ 
butes of characters in a particular character set, and produces a binary 
table file, to be read by setlocale (S), which determines the behavior of 
the ctype (S) and conv( S) routines. 

The information supplied in the specification file consists of lines in 
the following format: 

char type conv 

The three fields, which are separated by space or tab characters, have 
the following meanings and syntax: 

char This is the character which is being defined. It may be 
specified in one of six different ways (the following exam¬ 
ples all specify the ASCII character “A”): 


65 

decimal 

0101 

octal 

0x41 

hexadecimal 

’A’ 

quoted character 

Mor 

quoted octal 

\i4V 

quoted hexadecimal 


type This specifies the classification of the character, as reported 
by the ctype ( S) routines. There are 7 basic classifications: 

C iscntrl 
D sdigit 
L islower 
P ispunct 
S isspace 
U isupper 
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X isxdigit 


Other ctype macros use combinations of these 7 basic 
classifications. Zero, one or more of these classification 
letters can be specified, in any order, although only certain 
combinations are logically reasonable, as follows: 


C control character 

CS spacing control character 

U uppercase alphabetic 

UX uppercase alphabetic hex digit 

UL dual case character 

L lowercase alphabetic 

LX lowercase alphabetic hex digit 

DX decimal and hex digit 

S spacing character 

P punctuation (all other printing chars) 

blank undefined (all classifications false) 


conv This optional field specifies the corresponding upper case 
character for a lower case character, or the corresponding 
lower case character for an upper case character. Dual case 
characters should have their own values repeated in this 
field. 


The syntax is as for the char field. 

All characters following a hash (#) are treated as a comment and 
ignored up to the end of the line, unless the hash is within a quoted 
character. 

The initial LC.CTYPE table used is that for the ascii (M) character set, 
with the entries for the higher 128 characters (0x80 - Oxff) set to zero 
(i.e. all classifications false). Thus an empty specification file will 
result in a table for US ASCII. Any specifications found in the input to 
chrtbl will overwrite the specifications for that character only, thus 
additions and modifications to the ASCII table can be made without 
respecifying those characters which are unchanged. 

The binary table output is placed in a file named ctype, within the 
current directory. This file should be copied or linked to the correct 
place in the setlocale file tree (see locale (M)). To prevent accidental 
corruption of the output data, the file is created with no write permis¬ 
sion; if the chrtbl utility is run in a directory containing a write- 
protected “ctype” file, the utility will ask if the existing file should be 
replaced; any response other than “yes” or “y” will cause chrtbl to 
terminate without overwriting the existing file. 

If the specfile argument is missing, the specification information is 
read from the standard input. 
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Diagnostics 


CHRTBL(M) 


If the input table file cannot be opened for reading, processing will ter¬ 
minate with the error message, “Cannot open specification file”. 

Any lines in the specification file which are syntactically incorrect 
will cause an error message to be issued to the standard error output, 
specifying the line number on which the error was detected. The line 
will be ignored, and processing will continue. 

If the output file, “ctype”, cannot be opened for writing, processing 
will terminate with the error message, “Cannot create table file.” 

Any error conditions encountered will cause the program to exit with 
a non-zero return code; successful completion is indicated with a zero 
return code. 

Specification File Format 


The chrtbl specification file has the following format (the order of the 
specifications is not significant): 

# 

# chrtbl file for TVI 7-bit Spanish character set 

# Note that only non-ASCII characters need be specified 

# 


'0' 

P 

# 

inverted ? 

' [' 

L ']' 

# 

n tilde 

'W 

P 

# 

inverted ! 


U ' [' 

# 

N tilde 

r ~ r 

P 

# 

degree sign 

Files 





Aisr/include/ctype.h 


See Also 


ascii(M), conv(S), ctype(S), locale(M), setlocale(S) 

Value Added 


chrtbl is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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clone_ 

open any minor device on a STREAMS driver 

Description 

clone is a STREAMS software driver that finds and opens an unused 
minor device on another STREAMS driver. The minor device passed 
to clone during the open is interpreted as the major device number of 
another STREAMS driver for which an unused minor device is to be 
obtained. Each such open results in a separate stream to a previously 
unused minor device. 

The clone driver consists solely of an open function. This open func¬ 
tion performs all of the necessary work so that subsequent system calls 
[including close{ S)] require no further involvement of clone. 

clone will generate an ENXIO error, without opening the device, if die 
minor device number provided does not correspond to a valid major 
device, or if the driver indicated is not a STREAMS driver. 

Warnings 

Multiple opens of the same minor device cannot be done through the 
clone interface. Executing stat(S) on the file system node for a cloned 
device yields a different result from executing fstat{ S) using a file 
descriptor obtained from opening the node. 

See Also 


log(M) 

STREAMS Programmer's Guide 
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coltbl _ 

create a collation locale table 

Syntax 


coltbl [ specfile ] 

Description 


The utility coltbl is provided to allow LC.COLLATE locales to be 
defined. It reads in a specification file (or standard input if specfile is 
not defined), containing defintions for a particular locale’s collation 
ordering, and produces a concise format table file, to be read by 
setlocale(S). 

In general, characters may be specified in one of six different ways 
(the following examples all specify the ASCII character “A”): 


65 

decimal 

0101 

octal 

0x41 

hexadecimal 

’A’ 

quoted character 

Mor 

quoted octal 

’\x41’ 

quoted hexadecimal 


The information in the specification file is to an extent free format. A 
particular type of definition is started by one of the following key¬ 
words: 


PRIM: 

ZERO: 

EQUIV: 

DOUBLE: 

The keywords, PRIM:, ZERO: and EQUIV:, are concerned directly with 
the setting of the collation ordering of characters 

A group of characters which are to be collated as equal, unless all 
other characters in a pair of strings are also equal, are grouped 
together with the PRIM: keyword. The position of a particular group in 
the specification file is significant as far as the collation ordering is 
concerned. Collating elements following the PRIM: keyword are 
separated by white spaces. A two character collating element can be 
specified here by (a b), where a and b are the two characters making 
up the sequence. The order of the collating elements defined in one 
group is significant in secondary collation ordering. It is also possible 
to define a range of characters, for example: 
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PRIM: ’a’ - ’z’ 

Collating elements following the ZERO: keyword, are to be ignored 
when collating. The format of the definitions is the same as with 
PRIM: . Ranges of characters can also be defined, as for example: 

ZERO: 0x80 - 0x9f 

EQUIV: is used to give two collating elements identical positions in 
the collation ordering. The syntax is: 

EQUIV: a = b 

where a and b are the two equal collating elements. There can be only 
one definition for each occurrence of this keyword. 

Single characters which are to be collated as two characters, for exam¬ 
ple the German sharp s, are defined with the DOUBLE: keyword. The 
syntax is: 


DOUBLE: a = (b c) 

where a is the single character, and b and c are the two characters in 
the collating sequence. There can be only one definition for each 
occurrence of this keyword. The single character a must not also 
appear after a PRIM: , a ZERO: or a EQUIV: keyword. 

All characters following the hash character are treated as a comment 
and ignored up to the end of the line, unless the hash is within a 
quoted string. 

The concise format locale table is placed in a file named collate in the 
current directory. This file should be copied or moved to the correct 
place in the setlocale (S) file tree (see locale (M)). To prevent acciden¬ 
tal corruption of the output data, the file is created with no write per¬ 
mission; if the coltbl utility is run in a directory containing a write- 
protected collate file, the utility will ask if the existing file should be 
replaced - any response other than “yes” or “y” will cause coltbl to 
terminate without overwriting the existing file. 

See Also 


chrtbl(M), collation(S), locale(M), numtbl(M), mestbl(M), montbl(M), 
timtbl(M), setlocale(S) 

Diagnostics 

All error messages printed are self explanatory. 
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Value Added 


COLTBL (M) 


coltbl is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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console _ 

system console device 

Description 


The file /dev/console is the device used by the system administrator 
for system maintenance (single-user) operations. It is the tty to which 
the first default shell is attached. 

The system console device can be either a terminal (a serial adapter 
device, tty la) or a sytem keyboard display adapter monitor (ttyOl). 

Many programs, such as the UNIX kernel, redirect error messages to 
/dev/console. Initially /dev/console is linked to /dev/systty. 

Files 


/dev/console 

See Also 


boot(HW), screen (HW), systty(M), tty(M) 

Notes 


/dev/console should not be enabled, instead either the the display 
adapter (ttyOl) or the serial adapter device (ttyla) should be enabled. 

A serial console cannot be attached to a multiport card or one that 
uses special drivers; it must be on a standard COM1 card. 

Standards Conformance 


console is conformant with: 

The X/Open Portability Guide II of January 1987. 
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cvtcoff _ 

convert 386 COFF files to XENIX format 

Syntax 


cvtcoff [ -v ] [ -o outfile ] coff-file 

Description 


cvtcoff converts 386 Common Object Format Files (COFF) to the 
appropriate XENIX file format. If the file specified is a relocatable 
object module it is converted to Microsoft OMF format. If it is an 
executable binary it is converted to x.out format. 

If the file is a UNIX System V archive, it is converted to XENIX 
archive format and each file in the archive is converted as appropriate. 
Any files in the archive which are not in 386 COFF format are copied 
to the new archive unchanged, cvtcoff also creates a XENIX format 
—.SYMDEF symbol directory for the new archive. 

Options are: 

-v Verbose mode. The name of each member of an archive is 
displayed as it is converted. 

-o Output file name. The output file will be named a.out by default 
if no output file name is given. 


Notes 


Only essential symbol table information is converted. Source line 
numbers and additional symbol information for use by the symbolic 
debugger sdb will be ignored. 

Note that cvtcoff only converts 386 COFF files. It is not possible to 
convert 286 COFF files. 

Files 


x.out Default output file 

See Also 


cvtomf(M), 86rel(F), a.out(F), ar(F) 
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Value Added 


CVTCOFF (M) 


cvtcoff is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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cvtomf 

convert XENIX files to UNIX COFF format 

Syntax 


cvtomf omf-file 

Description 


cvtomf converts XENIX file format to 386 Common Object Format 
Files (COFF). If the file specified is a relocatable object module it is 
converted to COFF format. 

Notes 


Note that cvtomf only converts 386 XENIX files. It is not possible to 
convert 286 XENIX files. 

Be sure and consult the XENIX Compatibility Guide for possible pit- 
falls relating to file conversion. 

See Also 


cvtcoff(M), 86rel(F), a.out(F), ar(F), cc(CP) 

Value Added 


cvtomf is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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daemon.mn 


micnet mailer daemon 


Syntax 

/usr/lib/mail/daemon.mn [-ex] 

Description 

The mailer daemon performs the “backend” networking functions of 
the mail, rep, and remote commands by establishing and servicing the 
serial communication link between computers in a Micnet network. 

When invoked, the daemon creates multiple copies of itself, one copy 
for each serial line used in the network. Each copy opens die serial 
line, creates a startup message for the LOG file, and waits for a 
response from the daemon at the other end. The startup message lists 
the names of the machines to be connected, the serial line to be used, 
and the current date and time. If the daemon receives a correct 
response, it establishes the serial link and adds the message “first 
handshake complete” to the LOG file. If there is no response, the dae¬ 
mon waits indefinitely. 

If invoked with the -x switch, the daemon records each transmission in 
the LOG file. A transmission entry shows the direction of the 
transmission (tx for transmit, rx for receive), the number of bytes 
transmitted, the elapsed time for the transmission (in minutes and 
seconds), and the time of day of the transmission (in hours, minutes, 
and seconds). Each entry has the form: 

direction byte count elapsedjime time_of_day 

The daemon also records the date and time every hour. The date and 
time have the same format as described for the date command. 

If invoked with the -e switch, the daemon records all transmission 
errors in the LOG file. An error entry shows the cause of the error pre¬ 
ceded by the name of the daemon subroutine which detected the error. 

The mailer daemon is normally invoked by the start option of the 
netutil command and is stopped by the stop option. 

During the normal course of execution, the mailer daemon uses 
several files in the /usr/spool/micnet/remote directory. These files 
provide storage for LOG entries, commands issued by the remote (C) 
command, and a list of processes under daemon control. 
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Files 

/usr/lib/mail/daemon.mn 

/usr/spool/micnet/remote/*/LOG 

/usr/spool/micnet/remote/*/mn 

Aisr/spool/micnet/remote/local/mn* 

/usr/spool/micnet/remote/lock 

Aisr/spool/micnet/remote/pids 

See Also 

netutil(ADM) 


DAEMON.MN (M) 
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environ _ 

the user environment 

Description 

The user environment is a collection of information about a user, such 
as login directory, mailbox, and terminal type. The environment is 
stored in special “environment variables,” which can be assigned 
character values, such as names of files, directories, and terminals. 
These variables are automatically made available to programs and 
commands invoked by the user. The commands can then use the 
values to access the user’s files and terminal. 

The following is a short list of commonly used environment variables. 

PATH Defines the search path for the directories containing 

commands. The system searches these directories 
whenever a user types a command without giving a full 
pathname. The search path is one or more directory 
names separated by colons (:). Initially, PATH is set to 
:/bin:/usr/bin. 

HOME Names the user’s login directory. Initially, HOME is set 

to the login directory given in the user’s passwd file 
entry. 

EXINIT Used to set v/ options and define vi abbreviations and 
mappings. For Bourne Shell users, the syntax is: 

EXINIT = ’set options' 

For C-Shell users, the syntax is: 

setenv EXINIT ’set options' 

For example, a C-Shell user might place the following 
command in $HOME/.cshrc: 

setenv EXINIT ’set wm=24 | map g 1G’ 

This would automatically set vi’s wrapmargin option to 
24 and would define the “g” key to move to the top of 
the file (just as “G” moves to the bottom of the file). 
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You can set more than one option with the same set 
command. If you define abbreviations or mappings 
with this environment variable, you must separate the 
abbr and map commands from the set command and 
from each other with a bar (I). The function of the bar 
is similar to that of the semicolon that separates com¬ 
mands on a shell command line. 

If you are defining many customizations, you might 
prefer to use the .exrc file, where each command can be 
listed one per line (see v/(C)). 

TERM Defines the type of terminal being used. This informa¬ 

tion is used by commands such as more(C) which rely 
on information about the capabilities of the user’s ter¬ 
minal. The variable may be set to any valid terminal 
name (see terminals ( M)) directly or by using the 
tset(C ) command. 

TZ Defines time zone information. This information is used 

by date( C) to display the appropriate time. The vari¬ 
able may have any value of the form: 

xxxnzzzs; start /time, endltime 

where xxx is standard local time zone abbreviation (1-9 
characters), n is the standard time zone difference from 
GMT, and may be given as hh:mm:ss 
(hours:minutes:seconds), zzz is the summertime local 
time zone abbreviation of 1-9 characters (if any), s is 
the summertime time zone difference from GMT, and 
may be given as hh:mm:ss (hours:minutes:seconds), 
start and end specify the day to begin and end sum¬ 
mertime based on one of four rules, and time is the 
time of day the change to or from summertime occurs. 
The rules for specifying start and end are: 

1 based Julian day n 
n 0 based Julian day n 

W n.d nth day of week d 

Mm.n.d «th day of week d in month m 

For example: 


EST5:00:00EDT4:00:00;M4.1.0/2:00:00, M10.5.0/2:00:00. 
Refer to the rz(M) manual page for more on TZ. 
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HZ Defines, with a numerical value, the number of clock 

interrupts per second. The value of this variable is 
dependent on the hardware, and configured in the file 
etc/default/login. If HZ is not defined, programs which 
depend on this hertz value, such as prof(CP) and 
times{ S), will not ran. 

LANG Represents the international locale in the format 

language jerritory.codeset. This is used by 

setlocale (S) to establish the default locale on program 
startup. 

Individual locale-specific functions can be affected independently 
using the following optional environment variables: 

LCLCTYPE Locale affecting character classification routines 
(ctype(S)). 

LCLNUMERIC 

Locale affecting numeric formatting. 

LC_TIME Locale affecting time and date format. 

LC.COLLATE 

Locale affecting collation/sorting sequence. 
LC.MESSAGES 

Locale affecting message language. 

LC_MONETARY 

Locale affecting currency formatting. 

The environment can be changed by assigning a new value to a vari¬ 
able. An assignment has the form: 

name=value 

For example, the assignment: 


TERM=h29 


sets the TERM variable to the value “h29”. The new value can be 
“exported” to each subsequent invocation of a shell by exporting the 
variable with the export command (see sh(C)) or by using the env (C) 
command. 

You may also add variables to the environment, but you must be sure 
that the new names do not conflict with exported shell variables such 
as MAIL, PS1, PS2, and EFS. Placing assignments in the .profile file is 
a useful way to change the environment automatically before a session 
begins. 
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Note that the environment is made available to all programs as an 
array of strings. Each string has the form: 

name=value 


where the name is the name of an exported variable and the value is 
the variable’s cuirent value. For programs started with a exec (S) call, 
the environment is available through the external pointer environ . For 
other programs, individual variables in environment are available 
through getenv (S) calls. 

See Also 


env iP;wx ex ? c(S) ’ 8 etenv (S) setlocale(S), locale(M), login(M), 
profile(M), sh(C) 6 

Standards Conformance 


environ is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 
and NIST FIPS 151-1. 
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error _ 

kernel error output device 


Description 

System error messages are collected and made available to error log¬ 
ging daemons through the /dev/error device, /dev/error is a read¬ 
only device which returns one error per read and no EOF character. 
The /etc/rc2 scripts use a utility to read messages from /dev/error and 
write them to the system error log file /usr/adm/messages: 

/etc/logger /dev/error /usr/adm/messages & 

Any process can read /dev/error or arrange to be signaled when errors 
are queued in /dev/error. The following ioctl causes the error device 
to signal the process with SIGUSR1 when an error message is queued 
in /dev/error. 

♦include <signal.h> 

♦include <sys/eio.h> 

♦include <fcntl.h> 

int fd; 

fd = open("/dev/error", 0_RD0NLY); 
ioctl(fd, EMSG_SIG, SIGUSR1); 

Before exiting, the process must return /dev/error to its normal state. 
Do this with the following ioctl: 


ioctl(fd,EMSG_NOSIG, 0); 

Panic error messages are not logged in /dev/error. 

Files 


/dev/error 

See Also 

messages(M) 
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fcntl _ 

file control options 

Syntax 


#include <fcntl.h> 


Description 


The fcntl (S) function provides for control over open files. This 
include file describes requests and arguments to jcntl and open( S). 

/* Flag values accessible to open(S) and fcntl(S) */ 

/* (The first three can only be set by open) */ 

#define 0_RDQNLY 0 
#define OJWRONLY 1 
#define 0_RDWR 2 

#define OJNDELAY 04 /* Non-blocking I/O */ 

#define 0_APPEND 010 /* append (writes guaranteed at the end) */ 

#define 0_SYNC 020 /* synchronous write option */ 


/* Flag values accessible only to open(S) */ 

#define 0_CREAT 00400 /* open with file create (uses third open arg)*/ 

#define 0_TRUNC 01000 /* open with truncation */ 

#define 0_EXCL 02000 /* exclusive open */ 


/* fcntl(S) requests */ 
#define F_DUPFD 0 
#define F_GETFD 1 
#define F_SETFD 2 
#define F_GETFL 3 
#define F_SETFL 4 
#define F_GETLK 5 
#define F_SETLK 6 
#define F_SETLKW 7 
#define F CHKFL 8 


/* Duplicate fildes */ 

/* Get fildes flags */ 

/* Set fildes flags */ 

/* Get file flags */ 

/* Set file flags */ 

/* Get file lock */ 

/* Set file lock */ 

/* Set file lock and wait */ 

/* Check legality of file flag changes */ 


/* file segment locking control structure */ 
struct flock { 

short l_type; 
short l_whence; 
long l_start; 

long l_len; /* if o then until EOF */ 

short l_sysid; /* returned with F_GETLK*/ 

short 1j?id; /* returned with F GETLK*/ 

} 
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/* file segment locking types */ 

#define F_RDLCK 01 /* Read lock */ 

#define F_WRLCK 02 /* Write lock */ 

#define F UNLCK 03 /* Remove locks */ 


See Also 


fcntl(S), open(S) 

Standards Conformance 


fcntl is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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getclk __ 

gets string from real-time clock 

Syntax 

/etc/getclk 

Description 

getclk get a string suitable for date( C) from the real-time clock and 
write it to stdout. Exit code 1 if it doesn’t work, 0 if successful. 

See Also 

date(C) 
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getty _ _ 

sets terminal type, modes, speed, and line discipline 


Syntax 

/etc/getty [ -h ] [ -t timeout ] line [ speed [ type [ linedisc ] ] ] 

/etc/getty -c file 

Description 

getty is a program that is invoked by init (M). It is the second process 
in the series, ( init-getty-login-shell ), that ultimately connects a user 
with the UNIX system. Initially getty displays the login message field 
for the entry it is using from /etc/gettydefs. getty reads the user’s 
login name and invokes the login( M) command with the user’s name 
as argument. While reading the name, getty attempts to adapt the sys¬ 
tem to the speed and type of terminal being used. 

Line is the name of a tty line in /dev to which getty is to attach itself. 
getty uses this string as the name of a file in the /dev directory to open 
for reading and writing. The -t flag, plus timeout in seconds, specifies 
that getty should exit if the open on the line succeeds and no one 
enters anything in the specified number of seconds. The optional 
second argument, speed, is a label to a speed and tty definition in the 
file /etc/gettydefs. This definition tells getty what speed to initially 
run, what the login message should look like, what the initial tty set¬ 
tings are, and what speed to try next should the user indicate that the 
speed is inappropriate (by entering a BREAK character). The default 
speed is 9600 baud. 

Type, the optional third argument, is a character string describing to 
getty what type of terminal is connected to the line in question, getty 
recognizes the following types: 

none default 

ds40-l DATASPEED terminal 40/1 

tektronix,tek TEKTRONIX 

vt61 Digital Equipment vt61 

vtlOO Digital Equipment vtlOO 

hp45 Hewlett-Packard 45 

clOO Concept 100 

The default terminal is none; i.e., any crt or normal terminal unknown 
to the system. For terminal type to have any meaning, the virtual ter- 
minal handlers must be compiled into the operating system. They are 
available, but not compiled in the default condition. The optional 
fourth argument, linedisc, is a character string describing which line 
discipline to use in communicating with the terminal. Again the 
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hooks for line disciplines are available in the operating system but 
iniQrn ° nly ° ne presently available > *e default line discipline, 


When given no optional arguments, getty sets the speed of the inter¬ 
face to 9600 baud, specifies that raw mode will be used (awaken on 
every character), that echo will be suppressed, either parity allowed, 
that new-line characters will be converted to carriage return-line feed] 
and that tab expansion is performed on the standard output. It displays 
the login message before reading the user’s name a character at a time. 
If a null character (or framing error) is received, it is assumed to be 
the result of the user pushing the BREAK key. This will cause getty to 
attempt the next speed in the series. The series that getty tries is 
determined by what it finds in /etc/gettydefs. 

The user’s name is terminated by a new-line or carriage-return charac¬ 
ter. The latter results in the system being set to treat carriage returns 
appropriately (see ioctl( S)). 

The user s name is scanned to see if it contains any lower-case alpha¬ 
betic characters, getty suggests that the user use all lower-case charac¬ 
ters. If the user uses upper case characters, the system is told to map 
any future upper-case characters into the corresponding lower-case 
characters. 

Finally, login is exec’d with the user’s name as an argument. Addi¬ 
tional arguments may be typed after the login name. These are passed 
to login , which will place them in the environment [see login(M)]. 

A check option is provided. When getty is invoked with the -c option 
and file , it scans the file as if it were scanning /etc/gettydefs and 
prints out the results to the standard output. If there are any unrecog¬ 
nized modes or improperly constructed entries, it reports these. If the 
entries are correct, it displays the values of the various flags. See 
ioctl{S) to interpret the values. Note that some values are added to the 
flags automatically. 

Files 


/etc/gettydefs 

See Also 


lo S in ( M X uugetty(M), tty(HW), ioctl(S), gettydefs(F), 

mittab(F) 
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Notes 

While getty understands simple single character quoting conventions, 
it is not possible to quote certain special control characters used by 
getty. Thus, you cannot log in via getty and type a #, @, /, •, _, back¬ 
space, A U, "D, or & as part of your login name or arguments, getty 
uses them to determine when the end of the line has been readied, 
which protocol is being used, and what the erase character is. They 
will always be interpreted as having their special meaning. 

When connecting two computers using a direct connection, never 
invoke getty (M) on the ports of both machines. Instead, use 
uugetty (M). 
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init, telinit 


process control initialization 


Syntax 


/etc/init [0123456SsQqabc] 
/bin/telinit [ 0123456SsQqabc ] 

Description 


init is a general process spawner. Its primary role is to create pro- 
cesses from information stored in the file /etc/inittab [see inittab (F)]. 

At any given time, the system is in one of eight possible run levels. A 
run level is a software configuration of the system under which only a 
selected group of processes exist. The processes spawned by init for 
each of these run levels is defined in /etc/inittab. init can be in one of 
eight run levels, 0-6 and S or s (run levels S and s are identical). The 
run level changes when a privileged user runs /etc/init. This user- 
spawned init sends appropriate signals to the original init spawned by 
the operating system when the system was booted, telling it which run 
level to change to. 

If the file /etc/default/boot contains the string MAPKEY=YES init 
invokes Ae mapfey program (see mapkey( M)) to map the console key- 
board. If the call to mapkey succeeds, the console is set to 8-bits no 
caI1 fads, and the string SERIAL8=YES appears in 
/etc/default/boot, a serial console device is assumed and set to 8-bits 
no parity. 

The following are the arguments to init: 

0 shut the machine down so it is safe to remove the power. 
Have the machine remove power if it can. This state can 
be executed only from the console. 

1 put the system in single-user mode. Unmount all file sys¬ 
tems except root. All user processes are killed except 
those connected to the console. This state can be exe¬ 
cuted only from the console. 

put the system in multiuser mode. All multiuser environ¬ 
ment terminal processes and daemons are spawned. This 
state is commonly referred to as the multiuser state. 
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start the remote file sharing processes and daemons. 
Mount and advertise remote resources. Run leve * 
extends multiuser mode and is known as the remote-hle- 
sharing state. 

is available to be defined as an alternative multiuser 
environment configuration. It is not necessary for system 
operation and is usually not used. 

Stop the UNIX system and go to the firmware monitor. 

Stop the UNIX system and reboot to the state defined by 
the initdefault entry in /etc/inittab. 


a,b,c 


process only those /etc/inittab entries having the a, b or c 
nm level set. These are pseudo-states, which may be 
defined to run certain commands, but which do not cause 
the current run level to change. 


Q,q re-examine /etc/inittab. 

S s enter single-user mode. When this occurs, the terminal 
which executed this command becomes the system con¬ 
sole (see Notes for more information about console device 
assignment). This is the only run level that doesn’t require 
the existence of a properly formatted /etc/inittab file. If 
this file does not exist, then by default the only legal run 
level that init can enter is the single-user mode. When the 
system enters S or s, all mounted file systems remain 
mounted and only processes spawned by init are killed. 

When a UNIX system is booted, init is invoked and the following 
occurs, init first looks in /etc/default/boot to determme i f autoboot 
on panic is desired, init looks to see if DEFAULT LEVEL-N is 
specified in /etc/default/boot. If it is, then N is the default level, other¬ 
wise, the user is prompted to see if they wish to go to multiuser or sys¬ 
tem maintenance mode (single-user mode) In state, 

the virtual console terminal is assigned to the user s terminal and is 
opened for reading and writing. The sulogin command, which 
requires the user to enter the root password, is invoked and a message 
is generated on the physical console saying where 
has been relocated. Use either init or telmit to signal init to change 
the run level of the system. Note that if the shell is terminated (via an 
end-of-file), init will only re-initialize to the smgle-user state if the 
/etc/inittab file does not exist. 

If a 0 through 6 is entered, init enters the corresponding run level. 
Note that, on the 80386 computer, the run levels 0 1. 5. and 6 are 
reserved states for shutting the system down; the run levels 2,3, and 4 
are available as normal operating states. 
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On your computer, the run-levels 0 and 1 are reserved states for shut¬ 
ting the system down, and run-levels 2, 3, and 4 are available as nor¬ 
mal operating states. 

If this is the first time since power up that init has entered a run level 
other than single-user state, init first scans /etc/inittab for boot and 
bootwait entries [see inittab{ F)]. These entries are performed before 
any other processing of /etc/inittab takes place, providing that the run 
level entered matches that of the entry. In this way, any special ini¬ 
tialization of the operating system, such as mounting filesystems, can 
take place before users are allowed onto the system, init then scans 
/etc/inittab and executes all other entries that are to be processed for 
that run level. 

In a multiuser environment, /etc/inittab is set up so that init will cre¬ 
ate a getty process for each terminal that the administrator sets up to 
respawn. 

To spawn each process in /etc/inittab, init reads each entry and for 
each entry that should be respawned, it forks a child process, init 
spawns each process by forking a shell to run the job in. To set up the 
environment for this shell, init uses the /etc/initscript file which con¬ 
tains the definitions of some global variables, for example, TZ, HZ, 
and PATH. After it has spawned all of the processes specified by 
/etc/inittab, init waits for one of its descendant processes to die, a 
powerfail signal, or a signal from another init or telinit process to 
change the system’s run level. When one of these conditions occurs, 
init re-examines /etc/inittab. New entries can be added to /etc/inittab 
at any time; however, init still waits for one of the above three condi¬ 
tions to occur before re-examining /etc/inittab. To get around this, an 
initQ or initq command wakes init to re-examine /etc/inittab 
immediately. 

When init comes up at boot time and whenever the system changes 
from the single-user state to another run state, init sets the ioctl( S) 
states of the virtual console to those modes saved in the file 
/etc/ioctl.syscon. This file is written by init whenever the single-user 
state is entered. 

When a run level change request is made, init sends the warning sig¬ 
nal (SIGTERM) to all processes that are undefined in the target run 
level, init waits 5 seconds before forcibly terminating these processes 
via the kill signal (SIGKILL). 

The shell running on each terminal will terminate when the user types 
an end-of-file or hangs up. When init receives a signal telling it that a 
process it spawned has died, it records the fact and the reason it died 
in /etc/utmp and /etc/wtmp if it exists [see who( C)]. A history of the 
processes spawned is kept in /etc/wtmp. 
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Tf init receives a powerfail signal (SIGPWR) it scans /etc/inittab for 
special entries of the type powerfail and powerwait. These entries are 
invoked (if the run levels permit) before any further processing takes 
place. In this way init can perform various cleanup and recording 
functions during the powerdown of the operating system. Note that in 
the single-user states, S and s, only powerfail and powei'wait entries 
are executed, telinit , which is linked to /etc/init, is used to direct the , X 
actions of init. It takes a one-character argument and signals init to 
take the appropriate action. 


Files 


/etc/default/boot 

/etc/inittab 

/etc/utmp 

/etc/wtmp 

/etc/ioctl.syscon 

/etc/initscript 

/dev/console 

/dev/contty 

See Also 


disable(C), enable(C), login(M), sh(C), stty(C), who(C), getty(M), 
shutdown(M), sulogin(ADM), termio(HW), kill(S), gettydefs(F), 
inittab(F), utmp(F) 


Diagnostics 


If init finds that it is respawning an entry from /etc/inittab more than 
10 times in 2 minutes, it will assume that there is an error in the com¬ 
mand string in the entry, and generate an error message on the system 
console. It will then refuse to respawn this entry until either 5 minutes 
has elapsed or it receives a signal from a user-spawned init {telinit). 
This prevents init from eating up system resources when someone 
makes a typographical error in the inittab file or a program is removed 
that is referenced in /etc/inittab. 


When attempting to boot the system, failure of init to prompt for a 
new run level may be because the virtual system console is linked to a 
device other than the physical system console. 
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init and telinit can be run only by someone who is super-user. 

The S or s state must not be used indiscriminately in the /etc/inittab 
file. A good rule to follow when modifying this file is to avoid adding 
this state to any line other than the initdefault. 

The assignment of the console device may seem confusing at first. 
Whenever the system is rebooted, the first boot up messages will be 
displayed on the “normal” system console (ttyOl), then the prompt for 
going multiuser will be displayed on the the tty from which init S was 
last invoked, which could be any tty on the system. The system con¬ 
sole device (/dev/syscon) remains linked to the tty from which the last 
init S is invoked. Rebooting the system does NOT reset this to ttyOl. 

If the /etc/initscript file is not present, init will print a warning on the 
console and spawn the job without setting up the global environment. 

The change to /etc/gettydefs described in the Notes section of the 
gettydefs( F) manual page will permit terminals to pass 8 bits to the 
system as long as the system is in multiuser state (run level greater 
than 1). When the system changes to single-user state, the getty is 
killed and the terminal attributes are lost. To permit a terminal to pass 
8 bits to the system in single-user state, after you are in single-user 
state, type: 

stty -istrip cs8 

The /etc/TlMEZONE file must exist, /etc/initscript executes this file 
to set the correct TZ variable for the system. 

Standards Conformance 


init is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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isverify 

verifies ISAM database records 

Syntax 

isverify [ -Iilpyn] tablelist 


Description 


isverify detects and, if specified, repairs inconsistencies between 
ISAM data (.dat) files and index (.idx) files. The isverify utility 
checks that every valid record in the data file is properly represented 
in the index file; it also checks that every index entry points to a valid 
data record. 

tablelist is the list of tables to be checked by isverify. The .dat and 
.idx suffixes should not be included in the tablelist. 


Options_. 

You can specify any of the following flags when invoking isverify: 

-I after a system restore, an ISAM application can fail with 
the message: 

Error: Incorrect SCO Runtime System installed 

You can correct this situation by logging in as root and 
invoking isverify -I. 

-i Check only the index file (as opposed to checking both the 
index and the data files) for consistency. Use this option as 
a quick check if you think the data files are probably not 
corrupted. 

-1 prints a long listing of the information for each defined key 
(index), along with the associated data record pointer. The 
key value for each data record is displayed by key part, 
along with the byte position of the data record in the data 
file. This information is useful only if you understand the 
Indexed Sequential Access Method (ISAM). 

-p pauses after displaying information about each index. If 
you select this option, you must press the Break key before 
the isverify process continues. 
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-y causes isverify to assume a “yes” answer to each error 
state and to attempt to make the specified correction. It is 
recommended that you use this flag so that the isverify util¬ 
ity attempts to correct any discrepancies automatically. 

-n causes isverify to assume a “no” answer to each error state 
and to leave the files unchanged. It also allows you see 
where errors are by displaying them on the screen. 

Whether or not you use isverify with the -1 or -p flags, if an error is 
detected, you have the option of making a correction or leaving the 
files unchanged. If no errors are detected, no response is required. If 
you choose to make a correction, isverify attempts to repair the files. 
Unless the -y or -n flags are specified on the command line, you must 
choose interactively whether or not to make each correction. 
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jagent __ 

host control of windowing terminal 

Syntax 

#include <sys/jioctl.h> 

ioctl (cntlfd, JAGENT, &arg) 

int cntlfd 
struct bagent arg 

Description 

The ioctl(S) system call, when performed on an x((HW) device with 
the JAGENT request, allows a host program to send information to a 
windowing terminal. 

ioctl has three arguments: 

cntlfd the xt(HW) control channel file descriptor 

JAGENT the xt( HW) ioctl(S) request to invoke a windowing termi¬ 
nal agent routine. 

arg the address of a bagent structure, defined in <sys/jioctl.h> 

as follows: 


struct bagent { 

long size; /* size of src in & dest out */ 
char *src; /* the source byte string */ 
char *dest; /* the destination byte string */ 

}; 

The src pointer must be initialized to point to a byte string which is 
sent to the windowing terminal. See layers( M) for a list of JAGENT 
strings recognized by windowing terminals. Likewise, the dest 
pointer must be initialized to the address of a buffer to receive a byte 
string returned by the terminal. When ioctl(S) is called, the size argu¬ 
ment must be set to the length of the src string. Upon return, size is 
set by ioctl(S) to the length of the destination byte string, dest. 

See Also 

ioctl(S), libwindows(S), layers(M), xt(HW) 
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Upon successful completion, the size of the destination byte string is 
returned. If an error occurs, -1 is returned. 
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layers _ 

protocol used between host and windowing terminal 

under layers(C) 

Syntax 

#include <sys/jioctl.h> 

Description 


layers are asynchronous windows supported by the operating system 
in a windowing terminal. Communication between the UNIX system 
processes and terminal processes under layers^ C) occurs via multi¬ 
plexed channels managed by the respective operating systems using a 
protocol as specified in xtproto(M). 

The contents of packets transferring data between a UNIX system pro¬ 
cess and a layer are asymmetric. Data sent from the UNIX system to a 
particular terminal process is undifferentiated and it is up to the termi¬ 
nal process to interpret the contents of packets. 

Control information for terminal processes is sent via channel 0. Pro¬ 
cess 0 in the windowing terminal performs the designated functions on 
behalf of the process connected to the designated channel. These 
packets take the form: 


command, channel 

except for timeout and jagent information which take the form 


command, data... 

The commands are the bottom eight bits extracted from the following 

ioctl(S) codes: 

JBOOT Prepare to load a new terminal program into the desig¬ 
nated layer. 

JTERM Kill the downloaded layer program and restore the default 
window program. 

JTIMO Set the timeout parameters for the protocol. The data 
consist of two bytes: the value of the receive timeout in 
seconds and the value of the transmit timeout in seconds. 
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JTIMOM Set the timeout parameters for the protocol. The data 
consist of four bytes in two groups: the value of the 
receive timeout in milliseconds (the low eight bits fol¬ 
lowed by the high eight bits) and the value of the transmit 
timeout (in the same format). 

JZOMBOOT 

Like JBOOT, but do not execute the program after loading. 

JAGENT Send a source byte string to the terminal agent routine and 
wait for a reply byte string to be returned. 

The data are from a bagent structure [see jagent( M)] and 
consist of a one-byte size field followed by a two-byte 
agent command code and parameters. Two-byte integers 
transmitted as part of an agent command are sent with the 
high-order byte first. The response from the terminal is 
generally identical to the command packet, with the two 
command bytes replaced by the return code: 0 for success, 
-1 for failure. Note that the routines in the libwindows( S) 
library all send parameters in an agentrect structure. The 
agent command codes and their parameters are as fol¬ 
lows: 


followed by a two-byte channel 
number and a rectangle structure (four 
two-byte coordinates). 


ANEWLAYER 

ACURRENT 

ADELETE 

ATOP 

ABOTTOM 

AMOVE 

ARESHAPE 

A_NEW 


followed by a 
number. 

followed by a 
number. 

followed by a 
number. 

followed by a 
number. 


two-byte channel 
two-byte channel 
two-byte channel 
two-byte channel 


followed by a two-byte channel 

number and a point to move to (two 
two-byte coordinates). 

followed by a two-byte channel 

number and the new rectangle (four 
two-byte coordinates). 

followed by a two-byte channel 

number and a rectangle structure (four 
two-byte coordinates). 
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A_EXIT no parameters needed. 

A ROMVERSION no parameters needed. The response 
packet contains the size byte, two- 
byte return code, two unused bytes, 
and the parameter part of the terminal 
id string (e.g., “8;7;3”)* 


Packets from the windowing terminal to the UNIX system all take the 
following form- 


command, data... 

The single-byte commands are as follows: 

C SENDCHAR Send the next byte to the UNIX system pro¬ 

cess. 


C NEW Create a new UNIX system process group 

for this layer. Remember the window size 
parameters for this layer. The data for this 
command is in the form described by the 
jwinsize structure. The size of the window 
is specified by two 2-byte integers, sent 
low byte first. 

C UNBLK Unblock transmission to this layer. There 

is no data for this command. 

C DELETE Delete the UNIX system process group 

attached to this layer. There is no data for 
this command. 


C EXIT Exit. Kill all UNIX system process groups 

associated with this terminal and temiinate 
the session. There is no data for this com¬ 
mand. 

C DEFUNCT Layer program has died, send a terminate 

signal to the UNIX system process groups 
associated with this terminal. There is no 
data for this command. 

C SENDNCHARS The rest of the data are characters to be 
passed to the UNIX system process. 
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CRESHAPE The layer has been reshaped. Change the 

window size parameters for this layer. The 
data takes the same form as for the C_NEW 
command. 

See Also 


libwindows(S), jagent(M), xtproto(M), layers(C), xt(HW) 
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Id_ 

invokes the link editor 


Syntax 

Id [options] filename 

Description 

The Id command combines several object files into one, performs relo¬ 
cation, resolves external symbols, and supports symbol table informa¬ 
tion for symbolic debugging. It creates an executable program by 
combining one or more object files and copying the executable result 
to the file a.out. The filename must name an object or library file. By 
convention these names have the “.o” (for object) or “.a” (for 
archive library) extensions. If more than one name is given, the names 
must be separated by one or more spaces. If any input file, filename , 
is not an object file. Id assumes it is either an archive library or a text 
file containing link editor directives. By default, the file a.out is 
excutable if no errors occurred during the load. If errors occur while 
linking, Id displays an error message; the resulting a.out file is unexe¬ 
cutable. 

Id concatenates the contents of the given object files in the order given 
in the command line. Library files in the command line are examined 
only if there are unresolved external references encountered from pre¬ 
vious object files. 

The library is searched iteratively to satisfy as many references as 
possible and only those routines that define unresolved external refer¬ 
ences are concatenated. The library (archive) symbol table (see <zr(F)) 
is searched sequentially with as many passes as are necessary to 
resolve external references which can be satisfied by library members. 
Thus, the ordering of library members is functionally unimportant, 
unless there exist multiple library members defining the same external 
symbol. The library may be either a relocatable archive library or a 
shared library. Object and library files are processed at the point they 
are encountered in the argument list, so the order of files in the com¬ 
mand line is important. In general, all object files should be given 
before library files. Id sets the entry point of the resultmg program to 
the beginning of the first routine. 

Id should be invoked using the cc(CP) command instead of invoking it 
directly, cc invokes Id as the last step of compilation, providing all 
the necessary C-language support routines. Invoking Id directly is not 
recommended since failure to give command line arguments in the 
correct order can result in errors. 
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Generating COFF vs. x.out Binaries 


LD (M) 


When Id is called^ it scans all the object files that are to be linked. If 
they are all COFF objects, then the resulting binary will be in COFF 
of ob J' ect files to be linked are in x.out format, any 
COFF modules in the group will be converted to x.out and the result- 
mg binary will be in x.out format. 


Common Options 


The following options are recognized by Id, and are common to pro- 
CO f F ®" d x : out binaries. Refer to the sections “Linking 
COFF Bmanes and “Linking x.out Binaries” for options specific to 
producing these binaries. 

-o name 

Sets the executable program filename to name instead of a.out. 

-r XENIX VERSION: Invokes the incremental linker, /lib/Idr, with 
the arguments passed to Id to produce a relocatable output file. 

AT&T VERSION: Retains relocation entries in the output object file. 
Relocation entries must be saved if the output file is to become an 
input file in a subsequent Id run. The link editor will not complain 
about unresolved references, and the output file will not be executable. 

-s Strips line number entries and symbol table information from the 
output object file. 

-u symbol 

Designates the specified symbol as undefined. This is useful for 
loadmg entirely from a library, since initially the symbol table is 
empty and an unresolved reference is needed to force the loadmg 
of the first routine. The placement of this option on the Id line is 
significant; it must be placed before the library which will define 
the symbol. 

‘ V ®^ uts a messa 8 e giving information about the version of Id being 


Linking COFF Binaries 


The following options are recognized by Id for linking COFF binaries: 
-e epsym 

Set the default entry point address for the output file to be that of 
the symbol epsym. 
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“I ILL 

Set the default fill pattern for “holes” within an output section as 
well as initialized bss sections. The argument fill is a two-byte 
constant. 

-Lx Search a library lib;c.a, where * is up to nine characters. A library 
is searched when its name is encountered, so the placement of a-1 
is significant. By default, libraries are located in LIBDIR or LLIB- 
DIR. 


m Produce a map or listing of the input/output sections on the stan¬ 
dard output. 

-a Create an absolute file. This is the default if the -r option is not 
used. Used with the -r option, -a allocates memory for common 
symbols. 

-t Him off the warning about multiply-defined symbols that are not 
the same size. 

-x Do not preserve local symbols in the output symbol table; enter 
external and static symbols only. This option saves some space m 
the output file. 

-z Do not bind anything to address zero. This option will allow run¬ 
time detection of null pointers. 

L dir 

Change the algorithm of searching for libx.a to look in dir before 
looking in LIBDIR and LLIBDIR. This option is effective only if it 
precedes the *1 option on the command line. 

-M 

Output a message for each multiply-de fined external definition. 

-N Put the text section at the beginning of the text segment rather than 
after all header information, and put the data section immediately 
following text in the core image. 

^Use num as a decimal version stamp identifying the a.out file that 
is produced. The version stamp is stored in the optional header. 

^Change the default directory used for finding libraries. If L is 
specified, the first default directory which Id searches, LIBDIR, is 
replaced by dir. If U is specified and Id has been built with a 
second default directory, LLIBDIR, then that directory is replaced 
by dir. If Id was built with only one default directory and L is 
specified a warning is printed and the option is ignored. 
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The user must make sure that the most recent library versions have 
been processed with ranlib (CP) before linking. Library files for x.out 
format binaries must be in ranlib ( CP) format, that is, the first member 

must be named_.SYMDEF, which is a dictionary for the library. Id 

compares the modification dates of the library and the_.SYMDEF 

entry, so if object files have been added to the library since_.SYM¬ 

DEF was created, the link may result in an “invalid object module” 
that cannot run. 

The following options are recognized by Id for linking x.out binaries: 
-A num 

Creates a standalone program whose expected load address (in 
hexadecimal) is num. This option sets the absolute flag in the 
header of the a.out file. Such program files can only be executed as 
standalone programs. Options -A and -F are mutually exclusive. 

-B num 

Sets the text selector bias to the specified hexadecimal number. 

-c num 

Alters the default target CPU in the x.out header, num can be 0, 1, 
2, or 3 indicating 8086, 80186, 80286 and 80386 processors, 
respectively. The default on 8086/80286 systems is 0. The default 
on 80386 systems is 3. Note that this option only alters the default; 
if object modules containing code for a higher numbered processor 
are linked, then that will take precedence over the default. 

-C 

Causes the link editor to ignore the case of symbols. 

-D num 

Sets the data selector bias to the specified hexadecimal number. 

-F num 

Sets the size of the program stack to num bytes where num is a 
hexadecimal number. This option is ignored for 80386 programs 
which have a variable sized stack. By default 8086 programs have 
a variable stack located at the top of the first data segment, and 
80286 programs have a fixed size 4096 byte stack. The -F option 
is incompatible with the -A option that cannot be opened by more 
than one user at the same time. 

-g Includes symbolic information for sdb. 

-i Creates separate instruction and data spaces for small model pro¬ 
grams. When the output file is executed, the program text and data 
areas are allocated separate physical segments. The text portion 
will be read-only and shared by all users executing the file. 
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Sets advisory file locking. Advisory locking is used on files with 
access modes that do not require mandatory locking. 


■Lm 

Sets mandatory file locking. Mandatory file locking is used on files 
that cannot be opened by more than one process at a time. 

-m name 

Creates a link map file named name that includes public symbols. 

Mx 

Specifies the memory model, x can have the following values: 
s small 

m middle 

1 large 

h huge 

e mixed 

-n num 

Truncates symbols to the length specified by num. 

-N num 

Sets the pagesize to h ex-num (which should be a multiple of 512) - 
the default is 1024 for 80386 programs. 8086/80186/80286 pro¬ 
grams do not normally have page-aligned x.out files and the default 
for these is 0. 


-P 

Disables packing of segments 

-R Ensures that the relocation table is of non-zero size. Important for 
8086 compatibility. 

-Rd num 

Specify the data segment relocation offset (80386 only), num is 
hexadecimal. 

-Rt num 

Specify the text segment relocation offset (80386 only) num is hex¬ 
adecimal. 

-S num 

Sets the maximum number of segments to num. If no argument is 
given, the default is 128. 
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Files 


/bin/Id 


UBD1R/ libjc.a 

libraries 

LUBDIR! libjc.a 

libraries 

a.out 

output file 

UBDIR 

usually /lib 

LUBDIR 

usually /usr/lib 

See Also 



as(CP), cc(CP), masm(CP), mkshlib(CP), ranlib(CP), exit(S), end(S), 
a.out(F), ar(F). 


Notes 


Through its options and input directives, the common link editor gives 
users great flexibility; however, those who use the input directives 
must assume some added responsibilities. Input directives and options 
should insure the following properties for programs: 

C defines a zero pointer as null. A pointer to which zero has 
been assigned must not point to any object. To satisfy this, users 
must not place any object at virtual address zero in the 
program’s address space. 

When the link editor is called through cc(CP), a startup routine 
is linked with the user’s program. This routine calls exit( ) [see 
exit(S)] after execution of the main program. If the user calls 
the link editor directly, then the user must insure that the pro¬ 
gram always calls exit( ) rather than falling through the end of 
the entry routine. 

The symbols etext , edata, and end (see end{ S)) are reserved and are 
defined by the link editor. It is incorrect for a user program to redefine 
them. 

If the link editor does not recognize an input file as an object file or an 
archive file, it will assume that it contains link editor directives and 
will attempt to parse it. This will occasionally produce an error mes¬ 
sage complaining about “syntax errors”. 

Arithmetic expressions may only have one forward referenced symbol 
per expression. 

If you are using XENIX binaries, please refer to the manual entry for 
this utility in the XENIX Development Guide for information on the 
appropriate usage with XENIX binaries. 
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Standards Conformance 


Id is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 


LD (M) 
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locale _ 

the international locale 


Syntax 


language [ [ territory ] [. [ codeset ] ] ] 
"C" 


Description 


The international locale is a definition of the local conventions to be 
used by UNIX libraries (and hence utilities and applications) for 
features whose behavior varies internationally. 

The locale is specified by a character string of the form 
languageJerritory.codeset , where: 

language represents both the language of text files being used, 
and the preferred language for messages (where the 
utility or application is capable of displaying messages 
in many languages), 

territory represents the geographical location (usually the coun¬ 
try) determining such factors as currency and numeric 
formats, and 

codeset represents the character set in use for the internal 
representation of text. 

The locale string “french_canada.8859” could therefore represent a 
Canadian user using the French language, processing data using the 
ISO 8859/1 standard international character set. 

Each element ( language , territory or code set) can be up to 14 charac¬ 
ters long, and should use only alphanumeric ASCII characters (see 
ascii(M)). 

Note that the locale is not required to be completely specified: terri¬ 
tory and codeset are optional. When a locale is incompletely 
specified, missing values are sought in the following sequence: 

1. For each subclass, such as LC_TIME , in an environment variable 
of the same name as the subclass. 

2. In the LANG environment variable. 
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3. In the file / etc/default/lang . 

The special locale string “C”, used to represent the minimal environ¬ 
ment needed for the C programming language, is taken to be 
equivalent to “english_us.ascii’ 

The format of the file /etc/default/lang is at least one line, of the form: 

LANG= " language _territory. codeset" 

A partly specified locale string will be expanded to the first LANG = 
entry in which the specified locale fields match. 

Thus if the / etc!default/lang file contains the following: 


LANG=english_us.ascii 
LANG=english_uk.8859 
LANG=french_franee.8859 

A locale string “english_uk” will get expanded to 
“english_uk.8859”, whereas a locale string “french” will get 
expanded to “french_france.8859”. 

The information used to configure a particular locale is generated by 
the utilities chrtbl (M), coltbl (M), mestbl (M), monthly M), numtbl (M) 
and timtbl(M). The output files produced by these utilities (ctype , col¬ 
late , currency , messages , numeric and time respectively) must be 
installed in the correct place in the directory structure lusrllib/lang. 
The correct directory name is found by substituting the language, ter¬ 
ritory and codeset names into the string 
“/usT/lib/lang/language/territory/ codeset 9 ’. The files should be 
installed into this directory with their existing file name (such as 
ctype). 

A suggested naming convention for locales is as follows: 

language The name of the language, in English, such as: english, 
french, german. 

territory The name of the nation, in English, such as: us, uk, 
Canada, france, germany, Switzerland. 

codeset An identification of the codeset, such as: ascii, 8859. 

See Also 


chrtbl(M), coltbl(M), environ(M), mestbl(M), montbl(M), numtbl(M), 
setlocale(S), timtbl(M) 
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locale is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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log _ 

interface to STREAMS error logging and event tracing 


Description 

log is a STREAMS software device driver that provides an interface 
for the STREAMS error logging and event tracing processes 
[strerr( ADM), strace( ADM)], log presents two separate interfaces: a 
function call interface in the kernel through which STREAMS drivers 
and modules submit log messages; and a subset of ioctl( S) system 
calls and STREAMS messages for interaction with a user level error 
logger, a trace logger, or processes that need to submit their own log 
messages. 


Kernel Interface 

log messages are generated within the kernel by calls to the function 
strlog : 


strlog(mid, sid, level, flags, fmt, argl, ...) 

short mid, sid; 

char level; 

ushort flags; 

char *fmt; 

unsigned argl; 

Required definitions are contained in <sys/strlog.h> and <sys/log.h>. 
mid is the STREAMS module id number for the module or driver sub¬ 
mitting the log message, sid is an internal sub-id number usually used 
to identify a particular minor device of a driver, level is a tracing 
level that allows for selective screening out of low priority messages 
from the tracer, flags are any combination of SLJERROR (the mes¬ 
sage is for the error logger), SLTRACE (the message is for the tracer), 
SL_FATAL (advisory notification of a fatal error), and SL_NOTIFY 
(request that a copy of the message be mailed to the system adminis¬ 
trator). fmt is a printf(S) style format string, except that %s, %e, %E, 
%g, and %G conversion specifications are not handled. Up to NLO- 
GARGS (currently 3) numeric or character arguments can be provided. 


User Interface 

log is opened via the clone interface, /dev/log. Each open of /dev/log 
obtains a separate stream to log. In order to receive log messages, a 
process must first notify log whether it is an error logger or trace 
logger via a STREAMS I_STR ioctl call (see below). For the error 
logger, the I_STR ioctl has an ic_cmd field of I_ERRLOG with no 
accompanying data. For the trace logger, the ioctl has an ic_cmd field 
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of IJTRCLOG, and must be accompanied by a data buffer containing 
an array of one or more struct trace_ids elements. Each trace_ids 
structure specifies an mid, sid, and level from which message will be 
accepted, strlog will accept messages whose mid and sid exactly 
match those in the tracejds structure, and whose level is less than or 
equal to the level given in the tracejds structure. A value of-1 in any 
of the fields of the tracejds structure indicates that any value is 
accepted for that field. 

At most one trace logger and one error logger can be active at a time 
Once the logger process has identified itself via the ioctl call, log will 
begin sending up messages subject to the restrictions noted above, 
these messages are obtained via the getmsg(S) system call. The con¬ 
trol part of this message contains a log_ctl structure, which specifies 
the mid, sid, level, flags, time in ticks since boot that the message was 
submitted, the corresponding time in seconds since Jan. 1, 1970, and a 
sequence number. The time in seconds since 1970 is provided so that 
the date and time of the message can be easily computed, and the time 
in ticks smce boot is provided so that the relative timing of log mes¬ 
sages can be determined. 


Different sequence numbers are maintained for the error and trace log¬ 
ging streams, and are provided so that gaps in the sequence of mes¬ 
sages can be determined (during times of high message traffic, some 
messages may not be delivered by the logger to avoid hogging system 
resources). The data part of the message contains the unexpanded text 
of the format string (null terminated), followed by NLOGARGS words 
ror the arguments to the format string, aligned on the first word boun- 
dary following the format string. 

A process may also send a message of the same structure to log , even 
if it is not an error or trace logger. The only fields of the log_ctl struc- 
tUr f IP . con * r °l °f ^e message that are accepted are the level 
and flags fields, all other fields are filled in by log before being for¬ 
warded to the appropriate logger. The data portion must contain a null 
terminated format string, and any arguments (up to NLOGARGS) must 
be packed one word each, on the next word boundary following the 
end of the format string. 

Attempting to issue an IJTRCLOG or I_ERRLOG when a logging pro¬ 
cess of the given type already exists will result in the error ENXIO 
being returned. Similarly, ENXIO is returned for IJTRCLOG ioctls 
without any tracejds structures, or for any unrecognized IJSTR ioctl 
calls. Incorrectly formatted log messages sent to the driver by a user 
process are silently ignored (no error results). 
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Example of I_ERRLOG notification: 

struct strioctl ioc; 
ioc.ic cmd = I_ERRL0G; 

ioc.ic_timout = 0; /* default timeout (15 secs.) */ 

ioc.ic_len =0; 
ioc.ic_dp = NULL; 

ioctl (log, I_STR, &ioc); 

Example of I.TRCLOG notification: 

struct trace_ids tid[2]; 

tid[0] ,ti_mid = 2; 
tid[0] .ti_sid = 0; 
tid[0].ti_level =1; 

tid[l].ti_mid = 1002; 

tid[l] ,ti_sid = -1; /* any sub-id will be allowed */ 

tid[l] .ti_level = -1; /* any level will be allowed */ 

ioc. ic_cmd = I_TRCI£G; 
ioc.icjtimout = 0; 

ioc.ic_len = 2 * sizeof(struct trace_ids); 
ioc.ic_dp = (char *)tid; 

ioctl (log, IJSTR, &ioc); 

Example of submitting a log message (no arguments): 

struct strbuf ctl, dat; 

struct log_ctl lc; „ 

char *message = "Don't forget to pick up some milk on the way home 

ctl.len = ctl.maxlen = sizeof(lc); 
ctl.buf = (char *)&lc; 

dat. len = dat .maxlen = strlen (message) ; 
dat.buf = message; 

lc.level =0; 

lc. flags = SL_ERROR | SL_N0TIFY; 
putmsg(log f &ctl, &dat, 0); 


Files 


/dev/log <sys/log.h> <sys/strlog.h> 
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See Also 


LOG (M) 


strace(ADM), strerr(ADM), clone(M), intro(S), getmsg(S), putmsg(S) 
STREAMS Programmer’s Guide 
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login 


gives access to the system 

Syntax 

login [ name [ env-var ... ] ] 

Description 

The login command is used at the beginning of each terminal session 
to identify the user and allow them access to the system. It cannot be 
invoked except when a connection is first established, or after the pre¬ 
vious user has logged out by sending an end-of-file ( Ctrl-D ) to their 
initial shell. 

login asks for your user name (if not supplied as an argument), and, if 
appropriate, your password and a dialup password. Echoing is turned 
off (where possible) during the typing of the passwords, so it will not 
appear on the written record of the session. 

If you make a mistake in the login procedure you will receive the mes¬ 
sage 

Login incorrect 

and a new login prompt will appear. The number of login attempts 
you are allowed is configurable. If you make too many unsuccessful 
login attempts, you or the terminal can be locked out. 

If the login sequence is not completed successfully within a configur¬ 
able period of time (e.g., one minute), the user is returned to the “log¬ 
in:” prompt or silently disconnected from a dial-in line. 

After a successful login, accounting files (letclutmp and letdwtmp) are 
updated, the user is notified if they have mail, and the start-up shell 
files (i.e., .profile for the Bourne shell or .login for the C-shell) if any, 
are executed. 
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login checks /etc/default/Iogin for the following definitions of the 
form DEFINE=value: 

ALTSHELL 

If ALTSHELL is set to YES or if it is not present in 
/etc/default/login, then the SHELL environment variable is set to 
whatever shell is specified in the user’s /etc/passwd entry. If ALT¬ 
SHELL is set to NO, then the SHELL environment variable is set 
only if the shell is defined in the /usr/lib/mkuser directory (which 
is a list of recognized shells). 

CONSOLE 

The CONSOLE=<fev/ce entry means that root can only log in on 
the device listed. For example, CONSOLE=/dev/console restricts 
root logins to the console device. 

IDLEWEEKS 

If a password has expired, the user is prompted to choose a new 
one. If it has expired beyond IDLEWEEKS, the user is not 
allowed to log in, and must consult the system administrator. 
Works in conjunction with passwd( C). See cautions under Notes. 

OVERRIDE 

This allows root to log in on the console even if the protected pass¬ 
word database entry for root is corrupted, login checks 
/etc/default/login to see if there is an entry similar to the follow¬ 
ing, which identifies the tty to be used when doing an override log¬ 
in for root: 

OVERRIDE=tty01 

PASSREQ 

If PASSREQ=YES, this forces the user to select a password if they 
do not have one. PASSREQ=NO allows users to have accounts 
without passwords. See cautions under Notes. 

SUPATH 

IT a user’s UID is 0 (i.e. if this is the superuser), the PATH variable 
is set to SUPATH, if SUPATH is specified in /etc/default/login. It 
is not advisable for SUPATH to include the current directory sym¬ 
bol (.). Note that an empty directory or at the beginning 
or end) is equivalent to 

ULIMIT 

This variable defines the maximum allowable file size. The default 
is 2,097,152 blocks, or 1 gigabyte. When setting ULIMIT, be sure 
to specify even numbers, as the ULIMIT variable accepts a number 
of 512-byte blocks. 

UMASK 

This is the default file creation mask (see umask{ C)). 
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login initializes the user and group IDs and the working directory, 
then executes a command interpreter (usually sh(C)) according to spe¬ 
cifications found in the /etc/passwd file. Argument 0 of the command 
interpreter is a dash (-) followed by the last component of the 
interpreter’s pathname. The basic environment (see environ (M)) is 
initialized to: 

HOME= your-login-directory 
SHELL=last field ofpasswd entry 
MflJL=/usr/$,poo\/ma.i\/your-login-name 

Initially, umask is set to octal 022 by login. 


Files 


/etc/utmp 

Information on current logins 

/etc/wtmp 

History of logins since last multiuser 

/usr/spool/mail /name 

Mailbox for user name 

/etc/motd 

Message of the day 

/etc/default/login 

Default values for environment 
variables 

/etc/passwd 

Password file 

/etc/profile 

System profile 

$HOME/.profile 

Personal profile 

See Also 



environ(M), getty(ADM), initscript(F), machine(HW), mail(C), 
newgrp(C), passwd(C), passwd(F), profile(M), su(C), sh(C), ulimit(S), 
umask(C), who(C) 


Diagnostics 

Not on system console 

login is set up to allow root to log on on the console only, 
and you are not on the system console. 

Login incorrect 

The login or dialup password is incorrect. 
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Unable to change directory to dir 

login cannot change directories to the home directory as 
specified by letc/passwd. 

No utmp entry. You must exec ’login 1 from the lowest level ’sh’. 
init did not put an entry in utmp. 

No Root Directory 

The shell field starts with a and the attempt to do a 
chroot to the home directory failed. 

You don’t have a password. 

A password is required and it hasn’t been set previously. 

Protected Password information suddenly vanished 

During the course of working with the protected password 
database information the pointer pointing to the static ver¬ 
sion of the information has suddenly disappeared. 

Cannot execute passwd program 

The password program cannot be executed for some rea¬ 
son. 

Login aborted due to no password. 

The password program has returned an error while setting a 
password, as when the <DEL> key is pressed. 

Can’t rewrite protected password entry for user name, 
Authentication error; see Account Administrator 

The login program cannot update the protected password 
database entry. 

Protected Password database problem 

After updating Protected Password data, login reads the in¬ 
formation again and the entry cannot be read. 

Account is disabled but console login is allowed. 

Account is disabled — see Account Administrator. 

If the account is locked, but root is logging in on the con¬ 
sole (OVERRIDE tty), the first message is displayed; an 
ordinary user will see the second. 

Account has been retired ~ logins are no longer allowed. 

The account is retired (no override for this condition). 

Cannot set terminal mode. 

The chmod of the tty failed. 
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Bad login user id. 

No uid has been set. This can be due to a missing critical 
database file, such as letclauthlsystem!authorize. Run 
authck( ADM) and check any error messages. This mes¬ 
sage will also be issued if login is run from an established 
login session rather that from init( M). 

Wait for login retry. 

Wait for login exit. 

A login attempt has failed, and the system is configured to 
enforce a delay between login attempts. 

user appears in letclpasswd but not in Protected Password database 
If the user is in letclpasswd but not in the Protected Pass¬ 
word database, there is no message printed, but login gen¬ 
erates the preceding audit record. 

Cannot obtain database information on this terminal 

login cannot get information from the letclauthl system! ttys 
file for the tty line. 

Error in terminal setup. 

Something is wrong with the terminal setup (for example, 
stdin, stdout, and stderr are the same thing). 

Cannot obtain settings for this terminal 
The ioctl( S) on the tty device failed. 

No login program on root 

When attempting to do a sublogin (chrooting to a subtree 
for a restricted login), no login program was found. 

Cant rewrite terminal control entry for tty , 

Authentication error; see Account Administrator 

The information for the login tty cannot be updated. 

Terminal Control information suddenly vanished 

During the course of working with the terminal database 
information the pointer pointing to the static version of the 
information suddenly disappeared. 

Bad priority setting. 

nice failed to set the nice value specified in the Protected 
Password entry for the user. 

Bad group id. 

The call to setgid failed. 

Bad user id. 

The call to setuid failed. 
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Unable to set kernel authorizations. 

The call to set the kernel authorizations failed. 

Login timed out 

login received an ALARM signal. Note: login sets this 
itself, but it could conceivably come from somewhere else. 

Terminal is disabled but root login is allowed. 

Terminal is disabled - see Account Administrator. 

If the terminal is disabled, but you are root login in on the 
console (OVERRIDE tty) the first message is displayed; 
the second is displayed for ordinary users. 

The security databases are corrupt. 

However , root login at terminal tty is allowed , 

This is the message displayed when the OVERRIDE tty is 
used during a security problem. 

Impossible to execute /bin/sh! 

login cannot execute the shell program for doing an 
OVERRIDE. 


Notes 


login cannot be executed from a shell. 

Environment variables such as HZ, PATH, and so forth should not be 
defined in /etc/default/login. Instead use / etc/initscript to set global 
variables. 

Sublogins (indicated by a shell of “*”) are not supported and cause a 
warning. 

Although IDLEWEEKS and PASSREQ are supported for compatibil¬ 
ity with other UNIX systems, their use is not recommended. The 
proper way to set the behavior defined by these variables is by use of 
the sysadmsh(ADM) Accounts selection. 
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mapchan _ 

configure tty device mapping 

Syntax 

mapchan [-ans] [ -f mapfile ] [ channels ... ] 
mapchan [ [ -o ] [ -d ] ] [ channel ] 

Description 


mapchan configures the mapping of information input and output 
The mapchan utility is intended for users of applications that employ 
languages other than English (character sets other than 7-bit ASCII). 

mapchan translates codes sent by peripheral devices, such as termi¬ 
nals, to the internal character set used by the UNIX system, mapchan 
can also map codes in the internal character set to other codes, for out- 
put to peripheral devices (such as terminals, printers, console screen, 
etc.). Note that PC keyboard configuration is accomplished through 
the mapkey(M) utility. 6 

mapchan has several uses: to map a channel (-a or -s); to unmap a 
channel (-n and optionally -a); or to display the map on a channel 
(optionally -o, -d, channels). 

mapchan with no options displays the map on the user’s channel. The 
map displayed is suitable as input for mapchan. 

The options are: 

-a when used alone, sets all channels given in the default file 
(/etc/default/mapchan) with the specified map. When used 
with -n, it refers to all channels given in the default file. Super- 
user maps or unmaps all channels, other users map only chan¬ 
nels they own. -a can not be used with -d, -o, or -s. 

-d causes the mapping table currently in use on the given device, 
channel, to be displayed in decimal instead of the default hexa¬ 
decimal. An ASCE version is displayed on standard output. This 
output is suitable as an input file to mapchan for another chan¬ 
nel. Mapped values are displayed. Identical pairs are not out¬ 
put. -d can not be used with -a, -f, -n, -o, or -s. 

■f causes the current channel or list of channels to be mapped with 
mapfile. -f can not be used with -d, -n, -s, or -o. 
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-n causes null mapping to be performed. All codes are input and 
output as received. Mapping is turned off for the user s channel 
or for other channels , if given, -a used with -n will turn map¬ 
ping off on all channels given in the default file. This is the 
default mapping for all channels unless otherwise configured. - 
n can not be used with -d, -f, -o, or -s. 

-o causes the mapping table currently in use on the given device, 
channel , to be displayed in octal instead of the default hexade¬ 
cimal. An ASCH version is displayed on standard output. This 
output is suitable as an input file to mapchan for another port. 
Mapped values are displayed. Identical pairs are not output, -o 
can not be used with -a, -d, -f, -n, or -s. 

-s sets the user’s current channel with the mapfile given in the 
default file, -s can not be used with any other option. 

The user must own the channel in order to map it. The super-user can 
map any channel. Read or write permission is required to display the 
map on a channel. 

Each tty device channel (display adapter and video monitor on com¬ 
puter, parallel port, serial port, etc.) can have a different map. When 
UNIX boots, mapping is off for all channels . 

mapchan is usually invoked in the /etc/rc2 scripts. These scripts ^e 
executed when the system enters multi-user mode and sets up the 
default mapping for the system. Users can invoke mapchan when they 
log in by including a mapchan command line in their .profile or .login 
file In addition, users can remap their channel at any time by invok¬ 
ing mapchan from the command line, channels not listed in the 
default file are not automatically mapped, channels are not changed 
on logout. Whatever mapping was in place for the last user remains m 
effect for the next user, unless they modify their .profile or .login file. 

For example, the default file /etc/default/mapchan can contain: 

tty02 ibm 

ttyla 

tty2a wy60.ger 

Ip ibm 

The default directory containing mapfiles is /usr/lib/mapchan. The 
default directory containing channel files is /dev. Full pathnames may 
be used for channels or mapfiles. If a channel has no entry, or the 
entry field is blank, no mapping is enabled on that channel. Addi¬ 
tional channels added to the system, (for example, adding a senal or 
parallel port) are not automatically entered in the mapchan default 
file. If mapping is required, the system administrator must make the 
entries. 
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The format of the mapfles is documented in the mapchan( F) manual 
page. 


Using a Mapped channel 

The input infomiation is assumed to be 7- or 8-bit codes sent by the 
peripheral device. The device may make use of “dead” or “com¬ 
pose” keys to produce the codes. If the device does not have dead or 
compose keys, these keys can be simulated using mapchan. 

One to one mapped characters are displayed when the key is pressed, 
and the mapped value is passed to the kernel. 

Certain keys are designated as dead keys in the mapfile. Dead key 
sequences are two keystrokes that produce a single mapped value that 
is passed to the kernel. The dead key is usually a diacritical character, 
the second key is usually the letter being modified. For example, the 
sequence ' e could be mapped to the ASCII value 0xE9, and display as 


One key is designated as the compose key in the mapfile. Compose 
key sequences are composed of three keystrokes that produce a single 
mapped value that is passed to the kernel. The compose key is usually 
a seldom used character or Ctrl -letter combination. The second key is 
usually the letter being modified. The third key may be another char¬ 
acter being combined, or a diacritical character. For example, if ’ is 
the compose key, the sequence @ c O could be mapped to the ASCII 
value 0xA9, and display as ©. 

Characters are not echoed to the screen during a dead or compose 
sequence. The mapped character is echoed and passed to the kernel 
once the sequence is correctly completed. 

Characters are always put through the input map, even when part of 
dead or compose sequences. The character is then checked for the 
internal value. The value may also be mapped on output. This should 
be kept in mind when preparing map files. 

The following conditions will cause an error during input: 


• non-recognized (not defined in the mapfile ) dead or compose 
sequence 

• restarting a compose sequence before completion by pressing 
the compose key in the middle of a dead or compose sequence. 
This is an error, but a new compose sequence is initiated. 

If the mapfile contains the keyword beep, a bell sounds when either of 
the above conditions occurs. In either case, the characters are not 
echoed to the screen, or passed to the kernel. 
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In order to allow for character sequences sent to control the terminal 
(move the cursor, and so on) rather than to print characters on the 
screen, mapchan allows character sequences to be specified as special 
sequences which are not passed through the normal mapping pro¬ 
cedure. Two sections may be specified, one for each of the input (key¬ 
board) and output (screen) controls. 


Character Sets 

The internal character set used is defined by the mapfiles used. By 
default, this is the ISO 8859/1 character set which is also known as the 
dpANS X3.4.2 and ISO/TC97/SC2. It supports most of the Latin 
alphabet and can represent most European languages. 

Several partial map files are provided as examples. They must be 
modified for use with specific peripheral devices. Consult your 
hardware manual for the codes needed to display the desired charac¬ 
ters. Two map files are provided for use with the console device: 
/usr/lib/mapchan/ibm for systems with a standard PC character set 
ROM, and /usr/lib/mapchan/iso for systems with an optional ISO 
8859/1 character set ROM. 

Care should be taken that the stty(C) settings are correct for 8-bit ter¬ 
minals. The /etc/gettydefs file may require modification to allow log¬ 
ging in with the correct settings. 

7-bit U.S. ASCH (ANSI X3.4) should be used if no mapping is enabled 
on the channel. 


Files 


/etc/default/mapchan 

/usr/lib/mapchan/* 


See Also 


ascii(M), keyboard(HW), 
mapkey(M), parallel(HW), 
trchan(M), tty(M) 

lp(C), lpadmin(ADM), mapchan(F), 
screen(HW), serial(HW), setkey(M), 

Notes 



Some non-U.S. keyboards and display devices do not support charac¬ 
ters commonly used by UNIX command shells and the C programming 
language. It is not recommended that these devices be used for system 
administration tasks. 
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Printers can be mapped, output only, and can either be sent 8-bit codes 
or one-to-many character strings using mapchan. Line printer spooler 
interface scripts can be used (setuid root) to change the output map on 
the printer when different maps are required (as in c hangin g print 
wheels to display a different character set). See lp( C) and 
lpadmin(ADM) for information on installing and administering inter¬ 
face scripts. 


Not all terminals or printers can display all the characters that can be 
represented using this utility. Refer to the device’s hardware manual 
for information on the capabilities of the peripheral device. 

Warnings 


Use of mapfiles that specify a different 1 ’internal” character set per- 
channel, or a set other than the 8-bit ISO 8859 set supplied by default 
can cause strange side effects. It is especially important to retain the 
7-bit ASCII portion of the character set (see ascii(M)). UNIX utilities 
and many applications assume these values. 

Media transported between machines with different internal code set 
mappings may not be portable as no mapping is performed on block 
devices, such as tape and floppy drives. However, trchan with an 
appropriate mapfile can be used to “translate” from one internal char¬ 
acter set to another. 

Do not set ISTRIP (see stty (C)) when using mapchan. This option 
causes the eighth bit to be stripped before mapping occurs. 

Value Added 


mapchan is an extension of AT&T System V provided by the Santa 
Cruz Operation. 


March 15,1989 


MAPCHAN-5 







MAPKEY(M) 


MAPKEY(M) 


mapkey, mapscrn, mapstr, convkey 

configure monitor screen mapping 

Syntax 

mapkey [ -dox ][ datafile ] 
mapscrn [ -d ][ datafile ] 
mapstr [ -d ][ datafile ] 

convkey [ in [ out ] ] 

Description 


mapscrn configures the output mapping of the monitor screen on 
which it is invoked, mapkey and mapstr configure the mapping of the 
keyboard and string keys (eg. function keys) of the monitor (and mul¬ 
tiscreens if present), mapkey can only be run by the super-user. 

mapstr functions on a per-screen basis. Mapping strings on one screen 
does not affect any other screen. 

If a file name is given on the argument line the respective mapping 
table is configured from the contents of the input file. If no file is 
given, the default files in /usr/Iib/keyboard and /usr/lib/console is 
used. The -d option causes the mapping table to be read from the ker- 
nel instead of written and an ASCII version to be displayed on the 
standard output. The format of the output is suitable for input files to 
mapscrn , mapkey , or mapstr . Non-super-users can run mapkey and 
mapstr when the -d option is given. 

With the -o or -x options, mapkey displays the mapping table in octal 
or hexadecimal. 

convkey translates an old-style mapkey file into the current format. If 
in or out are missing, they default to stdin or stdout. 

Files 


/usr/lib/keyboard/* 

/usr/lib/console/* 
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MAPKEY(M) 


There is no way to specify that the map utilities read their configura- 
tion tables from standard input. 

See Also 

keyboard(HW), screen(HW), setkey(C) 

Value Added 


convkey, mapkey, mapsern and mapstr are extensions of AT&T Sys¬ 
tem V provided by the Santa Cruz Operation. 
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math _ 

math functions and constants 

Syntax 

#include <math.h> 


Description 

This file contains declarations of all the functions in the Development 
System Math Library as well as various functions in the C Library that 
return floating-point values. 

It defines the structure and constants used by the matherr(S ) error- 
handling mechanisms, including the following constant used as an 
error-return value: 

HUGE The maximum value of a single-precision 

floating-point number. 

The following mathematical constants are defined for user conveni¬ 
ence: 

M E The base of natural logarithms (e). 

M_LOG2E The base-2 logarithm of e. 


M_LOG10E 

M_LN2 

M_LN10 

M_PI 


The base-10 logarithm of e. 

The natural logarithm of 2. 

The natural logarithm of 10. 

7t, the ratio of the circumference of a circle to 
its diameter. 


M_PI_2 Jt/2. 

M_PI_4 Jt/4. 

M_1_PI 1/TC- 

M_2_PI 2/n. 

M_2_SQRTPI 2/Vre. 
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M_SQRT2 The positive square root of 2. 


M_SQRT1_2 The positive square root of 1/2. 


For the definitions of various machine-dependent 
description of the <values.h> header file. 


“constants,” see the 


See Also 


intro(S), matherr(S), values(M) 

Standards Conformance 

math is conformant with: 

The X/Open Portability Guide II of January 1987. 
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messages ___ 

description of system console messages 

Description 

This section describes the various system messages which may appear 
on the system console. All messages are displayed in the following 
format: 

label:severity:comment 
The segments break down as follows: 


label . 

Name of the driver or routine where the error occurred. 


severity 

The level of error severity, consisting of four levels: 


PANIC These fatal messages indicate hardware 

problems or kernel inconsistencies that 
are too severe for continued operation. 
After displaying a PANIC message, the 
system stops. Rebooting is required. 


ERROR Resource use has been affected. Some 
corrective action is needed. 


WARNING An error indication that should be moni¬ 
tored (example, free file space is low) 
but requires no immediate action. 

INFO Some information about the system is 

provided. 


comment 

A field containing 


information about the problem at hand. 


action 

The course of action to remedy the situation. 

The system services error messages are generated by the shell and do 
not follow the above convention. 

System Message Meanings 

The following classifications are meant to be a key for you to use to 
determine the actions to take to correct an error situation. Each kernel 
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message will have one of the following three classifications listed 
with it. The classifications are: 

System inconsistency 

A contradictory situation exists in the kernel. 

Abnormal 

A probably legitimate but extreme situation exists. 

Hardware 

Indicates a hardware problem. 

System inconsistency messages indicate problems usually traceable to 
hardware malfunction, such as memory failure. These messages 
rarely occur since associated hardware problems are generally 
detected before such an inconsistency can occur. 

Abnormal messages represent kernel operation problems, such as the 
overflow of critical tables. It takes extreme situations to bring these 
problems about, so they should never occur in normal system use. 
However, in some cases you can modify the kernel parameters that are 
causing the error message. Use the configure^ ADM) utility to make 
the necessary changes. 

Hardware messages normally specify the device, dev , that caused the 
error. Each message gives a device specification of the form nn/mm 
where nn is the major number of the device, and mm is its minor 
number. The command pipeline 

Is -1 /dev | grep nn | grep mm 

may be used to list the name of the device associated with the given 
major and minor numbers. 

System Messages 


** Normal System Shutdown ** 

This message appears when the system has been shutdown prop¬ 
erly. It indicates that the machine may now be rebooted or 
powered down. 

kernel :PANIC:** ABNORMAL System Shutdown ** 

This message appears when errors occur during system shut¬ 
down. It is usually accompanied by other system messages. 
System inconsistency , fatal. 

kemel:WARNING:bad block on dev nn/mm 

A nonexistent disk block was found on, or is being inserted in, 
the structure’s free list. System inconsistency. 
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kernel: WARNINGrbad count on dev nn/mm 

A structural inconsistency in the superblock of a file system. 
The system attempts a repair, but this message will probably be 
followed by more complaints about this file system. System 
inconsistency. 

kernel:WARNING:Bad free count on dev nn/mm 

A structural inconsistency in the superblock of a file system. 
The system attempts a repair, but this message will probably be 
followed by more complaints about this file system. System 
inconsistency. 

kemel:ERROR:error on dev name (nn/mm) 

This is the way that most device driver diagnostic messages 
start. The message will indicate the specific driver and com¬ 
plaint. The name is a word identifying the device. 

kemel:ERROR:iaddress > 2"24 

This indicates an attempted reference to an illegal block 
number, one so large that it could only occur on a file system 
larger than 8 billion bytes. Abnormal. 

kernel:WARNING:Inode table overflow 

Each open file requires an inode entry to be kept in memory. 
When this table overflows, the specific request (usually open( S) 
or creat(S)) is refused. Although not fatal to the system, this 
event may damage the operation of various spoolers, daemons, 
the mailer, and other important utilities. Abnormal results and 
missing data files are a common result. Use configure(ADM) to 
raise the number of inodes. Abnormal. 

kernel: WARNING:intenupt from unknown device, vec =num 

The CPU received an interrupt via a supposedly unused vector. 
This message is followed by “panic:unknown interrupt.” Typi¬ 
cally, this event comes about when a hardware failure miscom- 
putes the vector of a valid interrupt. Hardware. 

kemel:WARNING:stray interrupt on vector num 

The CPU received an interrupt via a supposedly unused vector. 
Hardware. 
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kernel: WARNING:no file 

JiJJ £?“ y °Pf n 1116 system has run out of entries 

“innH* fa w fi e fl ta ^, e ‘ warnm gs given for the message 

mode table overflow” apply here. Use configure/, ADM) to 

raise file total number of available files or the number of files 
available per process. Abnormal. 

kemel:WARNING:no space on dev nn/mm 

This message means that the specified file system has run out of 
free blocks. Although not normally as serious, the warnings dis- 
cussed for mode table overflow” applyroften user programs 
are written casually and ignore the error code returned when 
they med to write to the disk; this results in missing data and 
holes in data files. The system administrator should keep 
close watch on the amount of free disk space and take steps to 
avoid this situation. Abnormal. v 


kemel:WARNING:Out of inodes on dev nn/mm 

TTie indicated file system has run out of free inodes. The number 
of inodes available on a file system is determined when the file 
system is created (using mkfs{ADM)). The default number is 
quite generous; this message should be very rare. The onlv 
recourse is to remove some worthless files from that file system 
or dump the entire system to a backup device, run wi/i(ADM) 

formal m0deS SpeClfied ’ 311(1 restore toe files from backup. 


kemel:PANIC:blkdev 

An internal disk I/O request, already verified as valid, is 
discovered to be referring to a nonexistent disk. System incon¬ 
sistency, fatal. 

kemel:PANIC:devtab 

An internal disk I/O request, already verified as valid is 
discovered to be refering to a nonexistent disk. System incon- 
sistency, fatal. 


kemel:PANIC:iinit 


The super-block of the root file system could not be read 
message occurs only at boot time. Hardware, fatal 


This 


kemel:PANIC:swap 10 error 

A fatal I/O epor occurred while reading 
area. System inconsistency, fatal. 


or writing the swap 


kemel:PANIC:memory failure - parity error 

A hardware memory failure trap has been taken. System incon 
sistency, fatal. 


kemel:PANIC:no fs 

A mounted file system’s entry has disappeared from the 
mount table. System inconsistency, fatal. 


system 
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IcemelPANIC.no lmt has disappeared f rom the mount table. 

System inconsistency, fatal. 

kernel J^ANICnOgp^ited ^ ^ am£)unt of s i mu i ta neous processes he 
can have; an attempt to create a new process when none is 
available or when the user’s limit is exceeded and refused. That 
is an occasional event and produces no console messages, this 
panic occurs when the kernel has certified that a free process 
table entry is available and can’t find one when it goes to get it. 
System inconsistency, fatal. 

kernel:WARNING:Out of swap . ,, „ , ™ 

There is insufficient space on the swap disk to hold a task. The 
system refuses to create tasks when it feels there is insufficient 
disk space, but it is possible to create situations to circumvent 
this mechanism. Abnormal. 

kemel:PANIC:general protection trap 

General protection trap taken in kernel. System inconsistency, 

fatal. 

kemel:PANIC:segment not present ... ^„t it mflV 

An attempt has been made to access an invalid segment. It may 
also indicate the segment-not-present trap has been taken in the 
kernel. System inconsistency, fatal. 

kemel:PANIC:Timeout table overflow 

The timeout table is full. Timeout requests are generated by 
device drivers, there should usually be room for one entry per 
system serial line plus ten more for other usages. Use 
confi gwre(ADM) to raise the number of timeout table entries. 

kemel-PANIC:Trap in system 

The CPU has generated an illegal instruction trap while execut¬ 
ing kernel or device driver code. This message is preceded with 
an information dump describing the trap. System inconsistency, 
fatal. 


kemel:PANIC:Invalid TSS 

Internal tables have become corrupted. 
fatal. 

kernel:WARNING-.bootstring invalid, ignored 

A bad bootstring was entered at the Boot prompt. 

kemel:ERROR:bad syntax - string 

A bad bootstring was entered at the Boot prompt. 


System inconsistency, 
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kemel:PANIC:bad mapping in copyio 

Copyio was called with a strange request. Usually a bad driver. 

kernel:WARNING:HARDWARE FAILURE:386 incorrectly multi¬ 
plies 32-bit numbers 

The cpu is displaying the 32-bit multiply bug. 

kemekPANIC:*** POWER CYCLE TO REBOOT *** 

This message follows the above HARDWARE FAILURE 32 bit 
error message. 

kemel:INFO:10 bits of I/O address decoding 

The hardware is only decoding 10 bits of i/o addresses. This 
amount is sufficient in most cases. This condition is only an 
issue if you are strapping i/o devices with a base address above 
400 (hex). 

kernel:WARNING:A31 CPU bug workaround not possible for this 
machine 

A31 was specified on the boot line, but cannot be applied to the 
current system. 

kemel:INFO:A31 CPU bug workaround in effect 

A31 was specified on the boot line and the software workaround 
is currently in effect. 

kemel:PANIC:bad boot string An invalid boot string was entered at 
the Boot prompt. 

kemekPANIC:** WYSE/SCO UNIX only operates on WYSE PC sys¬ 
tems ** 

A kernel was serialized for WYSE hardware only and is being 
booted on a non-WYSE machine. 

kemekPANIC.out of both memory & swap 

No more memory pages or swap pages are free. 

kemel:PANIC:not enough contiguous memory 

The kernel memory allocation routines require more physically 
contiguous memory. Either decrease the size of some kernel 
parameters (like disk buffers) or add more physical memory. 

kemel:WARNING:filesystem page read failed 

An error occurred trying to read a page from the disk. This is 
not fatal, but usually indicates hardware problems. 

kernel:PANIC:free inode isn’t 

There is internal inode table corruption within the kernel. 

kemel:ERROR:Map overflow (num), shutdown and reboot, mp- 
>mpent 

There are internal kernel map inconsistencies. Reboot your 
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system. 

kemel:PANIC:write_sb():cannot cvts3superb() yet 

This message is found in the 386 kernel only. A write of a non 
SYS HI or SYS V filesystem superblock is being attempted. 
This action should be impossible due to earlier checks. 

kemel:WARNING:Can’t allocate message buffer 

This message indicates a lack of memory. Processes should be 
killed to make more room. Another option is to add more physi¬ 
cal memory. 

kemel:PANIC:Large model 386 ssig 

Internal kernel error in processing large model 386 signals. 

Trap type 

This message precedes a “kernel‘.PANIC:” message. The type 
is the trap number given by the processor. The message is fol¬ 
lowed by a dump of registers. System inconsistency, fatal. 

fpsave:PANIC:no fp_task 

No floating point context to save, internal kernel error. 

mdep.386/fp.c:WARNING:No floating point emulator found in string , 
No / etc!emulator was present in the root filesystem. The System 
Administrator should install one and reboot. 

fp_OVERRUN:PANIC:coprocessor overrun - with no 287/387 
Internal coprocessor error, fatal. 

fp_COPROC:PANIC:, coprocessor error - with no 287/387 
Inconsistent kernel internal state. 

fp_COPROC:PANIC:coprocessor error - switched away from fp_task 
Internal kernel mismanagement of floating point processes. 

fp_DNA:PANIC: 

A device trap happened while emulating floating point instruc¬ 
tions. 

iinit:PANIC:cannot copy in superblock 

An error happened during the root filesystem superblock load¬ 
ing. 

srmount:PANIC:cannot cvtv7superb() yet 

A root filesystem superblock was not recognized as a SYS III or 
SYS V superblock. V7 superblocks cannot currently be con¬ 
verted on the 386 kernel. 

mapphys:PANIC:sptmap overflow 

No system page table pages are available. This is an internal 
error in the kernel, usually caused by a faulty device driver. 
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physio:PANIC:bad state A device driver made an invalid request to 
physio. 

badint:PANIC:bad interrupt handler Invalid interrupt request, usually 
fault hardware. 

setup:PANIC:sptmap overflow This message indicates possible kernel 
image corruption or lack of physical memory. 

setup:PANIC:u-area not page aligned This indicates possible kernel 
image corruption. 

setup:PANIC:u-area address does not match SPTADDR 
Indicates possible kernel image corruption. 

cmn_err:PANIC:DOUBLE PANIC The kernel panicked while trying 
to panic. You must power cycle at this point to reboot the 
machine. 

cmn_err:PANIC:unknown level in cmn_err (level=«wm, msg =string), 
The kernel’s cmn_err() routine was called with an invalid argu¬ 
ment. 


Kernel Paging Messages 

The following messages indicate system inconsistencies in the kernel 
paging code. These inconsistencies can be caused by hardware or 
software problems. Reboot your system and note the circumstances if 
you see one of these messages: 

mfalloc:PANIC:page not free 

mfalloc:PANIC:page not free at exit 

mflree:PANIC:page already free 

mflree:PANIC:page is locked 

dfalloc:PANIC:frame not free at exit 

xlcheck:PANIC:xlink serial mismatch 

impcode:PANIC:called to load impure 386 

impcode:PANIC:more than 1 data segment? 

preload:PANIC:, invalid page ( num , nurri) 

kemel:PANIC:bad page type for protection fault 
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kemel:PANIC:protection fault on read access 

kemel:PANIC:not present fault on shared data 

kemel:PANIC:added strange page table - num, index 

pgfind:PANIC:not in cache 

pghash:PANIC:not in cache 

pginval:PANIC:list broken 

pginval:PANIC:not in cache 

mftomp:PANIC:bad frameno num 

mptomf:PANIC:bad mp num 

swapadd:PANIC:no space for dpfi 

dftodp:PANIC:bad frameno num 

dptodf:PANIC:bad dp num 

dptodf:PANIC:bad dp num 

pgread:PANIC:no xlink 

pgfree:PANIC:invalid page marked present 

pgfree:PANIC:freeing intransit page 

pgpid:WARNING:setting disk pid 

kemel:PANIC:page table under page table? 

kemel:PANIC:swapping intransit page 

dftomf:PANIC:non-swap page table entry changed 

dftomf:PANIC:swap disk frame rcnt(m/m) != 1, dp=num, dp- 

>dp_rcnt,dp 

dftomf:PANIC:page type mismatch - mptype num dptype num mp num 
dp num, mp->mp_type, dp->dp_type, mp, dp 

dftomf2:PANIC:, swap memory frame rcnt(wwm) != 1, mp=num, 

dftomf3:PANIC:swap mem frame rent (num) != 1, mp =num, mp- 
>mp_rcnt, mp 
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mftodfl:PANIC:swap mem frame rent {num) != 1, mp =num, mp- 
>mp_rcnt, mp 

mftodf:PANIC:memory frame marked in transit 

mftodf:PANIC:page type mismatch - dptype num mptype num dp num 
mp num 

mftodf2:PANIC:swap disk frame rent (num) != 1, dp=num 

mftodf3:PANIC:swap disk frame rent (num) != 1, dp =num, dp- 
>dp_rcnt, dp 

fftomf:PANIC:page typ e(num) not TE_FTLSYS, mp = num, mp- 
>mp_type, mp 

mfcvt:PANIC:zero ref count 

ptdup:PANIC:TE_SWAP page rent (num) > 1, 

ptdup:PANIC:xlinked page has reference 

ptdup2:PANIC:TE_SWAP page rent > 1 

ptdup:PANIC:xlinked page has reference 

ptdup:PANIC:locked page not present 

ptdup:PANIC:intransit page 

pgcheck:PANIC:page type mismatch:ptp num type num xtype 
wwm,ptp,type,xtype 

The above listed messages indicate system inconsistencies in the ker¬ 
nel paging code. These inconsistencies can be caused both by 
hardware or software problems. Reboot your system. 

cputok:PANIC: 

cpktourPANIC: 

sdfrcm:PANIC:sdp->sd_inode not found 

The above 3 errors indicate internal shared data errors within the ker¬ 
nel. 

v86sighdlint:WARNING:lost signal 
v86setint:P ANIC:xtss pte not present 
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The above 2 errors indicate internal VPIX processing errors within the 
kernel. 

namei:PANIC:null cache ino 
namei:PANIC:duplicating cache 

The above 2 messages indicate internal file management errors in the 
kernel. 

System Services Messages 


The following messages are displayed by the shell when a system call 
fails. 

Not owner: 

Typically, this error indicates an attempt to modify a file in some 
way forbidden except to its owner or super-user. It is also returned 
for attempts by ordinary users to do filings allowed only to the 
super-user. 

No such file or directory: 

This error occurs when a filename is specified and the file should 
exist but doesn’t, or when one of the directories in a pathname does 
not exist. 

No such process: 

No process can be found corresponding to that specified by pid in 
kill or ptrace. 

Interrupted system call: 

An asynchronous signal (such as interrupt or quit), which the user 
has elected to catch, occurred during a system call. If execution is 
resumed after processing the signal, it will appear as if the inter¬ 
rupted system call returned this error condition. 

I/O error: 

Some physical I/O error. This error may in some cases occur on a 
call following the one to which it actually applies. 

No such device or address: 

I/O on a special file refers to a subdevice which does not exist, or 
beyond the limits of the device. It may also occur when, for exam¬ 
ple, a tape drive is not on-line or no disk pack is loaded on a drive. 

Arg list too long: 

An argument list longer than 5,120 bytes is presented to a member 
of the exec family. 
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Exec format error: 

A request is made to execute a file which, although it has the 
appropriate permissions, does not start with a valid magic number 
(see a.out( F)). 

Bad file number: 

Either a file descriptor refers to no open file, or a read (respectively 
write) request is made to a file which is open only for writing 
(respectively reading). 

No child processes: 

A wait was executed by a process that had no existing or 
unwaited-for child processes. 

No more processes: 

A fork failed because the system’s process table is full or the user 
is not allowed to create any more processes. 

Not enough space: 

During an exec, or sbrk, a program asks for more space than the 
system is able to supply. This is not a temporary condition; the 
maximum space size is a system parameter. The error may also 
occur if the arrangement of text, data, and stack segments requires 
too many segmentation registers, or if there is not enough swap 
space during a fork. 

Permission denied: 

An attempt was made to access a file in a way forbidden by the 
protection system. 

Bad address: 

The system encountered a hardware fault in attempting to use an 
argument of a system call. 

Block device required: 

A nonblock file was mentioned where a block device was required, 
e.g., in mount. 

Device busy: 

An attempt to mount a device that was already mounted or an 
attempt was made to dismount a device on which there is an active 
file (open file, current directory, mounted-on file, active text seg¬ 
ment). It will also occur if an attempt is made to enable account¬ 
ing when it is already enabled. 

File exists: 

An existing file was mentioned in an inappropriate context, e.g., 
link. 

Cross-device link: 

A link to a file on another device was attempted. 
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No such device: 

An attempt was made to apply an inappropriate system call to a 
device; e.g., read a write-only device. 

Not a directory: 

A nondirectory was specified where a directory is required, for 
example, in a path prefix or as an argument to chdir(S). 

Is a directory: 

An attempt to write on a directory. 

Invalid argument: 

An invalid argument (e.g., dismounting a nonmounted device; 
mentioning an undefined signal in signal or kill ; reading or writing 
a file for which Iseek has generated a negative pointer). Also set 
by the math functions described in the (S) entries of this manual. 

File table overflow: 

The system’s table of open files is full and temporarily no more 
opens can be accepted. 

Too many open files: 

No process may have more than 60 file descriptors open at a time. 
Not a character device 
Text file busy: 

An attempt to execute a pure-procedure program which is 
currently open for writing (or reading). Also an attempt to open 
for writing a pure-procedure program that is being executed. 

File too large: 

The size of a file exceeded the maximum file size (1,082,201,088 
bytes) orULIMIT; see ulimit( S). 

No space left on device: 

During a write to an ordinary file, there is no free space left on the 
device. 

Illegal seek: 

An Iseek was issued to a pipe. 

Read-only file system: 

An attempt to modify a file or directory was made on a device 
mounted read-only. 

Too many links: 

An attempt to make more than the maximum number ot links 
(1000) to a file. 
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Broken pipe: 

A write on a pipe for which there is no process to read the data. 
This condition normally generates a signal; the error is returned if 
the signal is ignored. 

Arg out of domain of func: 

The argument of a function in the math package is out of the 
domain of the function. 

Result too large: 

The value of a function in the math package is not representable 
within machine precision. 

File system needs cleaning: 

An attempt was made to mount( S) a file system whose super-block 
is not flagged clean. 

Would deadlock: 

A process’ attempt to lock a file region would cause a deadlock 
between processes vying for control of that region. 

Not a name file: 

A creatsem (S), opensem( S), waitsem( S), or sigsem(S ) was issued 
using an invalid semaphore identifier. 

Not available: 

An opensem(S), waitsem(S) or sigsem( S) was issued to a sema¬ 
phore that has not been initialized by a call to creatsem (S). A sig- 
sem was issued to a semaphore out of sequence; i.e., before the 
process has issued the corresponding waitsem to the semaphore. 
An nbwaitsem was issued to a semaphore guarding a resource that 
is currently in use by another process. The semaphore on which a 
process was waiting has been left in an inconsistent state when the 
process controlling the semaphore exits without relinquishing con¬ 
trol properly; i.e., without issuing a waitsem on the semaphore. 

A name file: 

A name file (semaphore, shared data, etc.) was specified when not 
expected. 

No message of desired type: An attempt was made to receive a mes¬ 
sage of a type that does not exist on the specified message queue 
[see msgop(S)]. 

An attempt was made to receive a message of a type that does not 
exist on the specified message queue; see msgop(S). 

Identifier removed: 

This error is returned to a process that resumes execution due to 
the removal of an identifier from the file system’s 
name space; see msgctl(S), semctl(S ), and shmctl( S). 


March 15, 1989 


MESSAGES-14 




MESSAGES (M) 


MESSAGES (M) 


No record locks available: 

Jnfcntl(S) the setting or removing of record locks on a file cannot 
be accomplished because there are no more record entries left on 
the system. 

Channel number out of range 
Level 2 not synchronized 
Level 3 halted 
Level 3 reset 
Link number out of range 
Protocol driver not attached 
No CSI structure available 
Level 2 halted 


Deadlock situation detected/avoided 

A deadlock situation was detected and avoided. This error pertains 
to file and record locking. 

No record locks available 

Bad exchange descriptor 

Bad request descriptor 

Message tables full 

Inode table overflow 


Bad request code 
Invalid slot 


File locking deadlock 
Bad font file format 
Not a stream device 

A putmsg( S) or getmsg( S) system call was attempted on a file 
descriptor that is not a STREAMS device. 

No data available 


Timer expired . , _ 

The timer set for a STREAMS ioctl( S) call has expired. The cause 
of this error is device specific and could indicate either a hardware 
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or software failure, or perhaps a timeout value that is too short for 
the specific operation. The status of the ioctl(S) operation is 
indeterminate. 

Out of stream resources 

During a STREAMS open( S), either no STREAMS queues or no 
STREAMS head data structures were available. 

Machine is not on the network 

This error is Remote File Sharing (RFS) specific. It occurs when 
users try to advertise, unadvertise, mount, or unmount remote 
resources while the machine has not done the proper startup to 
connect to the network. 

Package not installed 

This error occurs when users attempt to use a system call from a 
package which has not been installed. 

Object is remote 

This error is RFS specific. It occurs when users try to advertise a 
resource which is not on the local machine, or try to 
mount/unmount a device (or pathname) that is on a remote 
machine. 

Link has been severed 

This error is RFS specific. It occurs when the link (virtual circuit) 
connecting to a remote machine is gone. 

Advertise error 

This error is RFS specific. It occurs when users try to advertise a 
resource which has been advertised already, or try to stop the RFS 
while there are resources still advertised, or try to force unmount a 
resource when it is still advertised. 

Srmount error 

This error is RFS specific. It occurs when users try to stop RFS 
while there are resources still mounted by remote machines. 

Communication error on send 

This error is RFS specific. It occurs when trying to send messages 
to remote machines but no virtual circuit can be found. 

Protocol error 

Some protocol error occurred. This error is device specific, but is 
generally not related to a hardware failure. 

Multihop attempted 

This error is RFS specific. It occurs when users try to access 
remote resources which are not directly accessible. 
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Not a data message 

During a read{ S), getmsg(S), or ioctl( S) I_RECVFD system call to a 
STREAMS device, something has come to the head of the queue 
that can’t be processed. That something depends on the system 
call: 

read{ S) - control information or a passed file descriptor. 
getmsglS) - passed file descriptor. 
ioctl(S) - control or data information. 

Name not unique on network 

File descriptor in bad state 

Remote address changed 

Cannot access a needed shared library 

Trying to exec(S) an a.out that requires a shared library (to be 
linked in) and the shared library doesn’t exist or the user doesn’t 
have permission to use it. 

Accessing a corrupted shared library 

Trying to exec(S) an a.out that requires a shared library (to be 
linked in) and exec(S) could not load the shared library. The shared 
library is probably corrupted. 

Trying to exec(S) an a.out that requires a shared library (to be linked 
in) and there was erroneous data in the .lib section of the a.out. The 
.lib section tells exec( S) what shared libraries are needed. The 
a.out is probably corrupted. 

Attempting to link in more shared libraries than system limit 

Trying to exec(S) an a.out that requires more shared libraries (to be 
linked in) than is allowed on the current configuration of the sys¬ 
tem. See the System Administrator’s Guide. 

Cannot exec a shared library directly 

Trying to exec(S) a shared library directly. This is not allowed. 


Driver Messages 

The following messages are different from kernel messages in that 
they are generated by the device drivers for the various hardware sup¬ 
ported under UNIX. The source of the message can be determined by 
checking the label field of the message. 


Console Driver Messages 

console:WARNING:Kemel messages lost on non-text screen 
(also check /usr/adm/messages) 

Kernel messages were lost while the console was in graphics 
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mode and did not appear. Check the last lines of 
/usr/adm/messages to find the messages. 

console:WARNING:Too many keyboard groups 

There are more video devices attached to your system than your 
kernel is designed to support. 


Irwin Driver Messages 

IRWIN:ERROR:Tape bad block table was not successfully read. 

When the tape device is open the bad block table is read into 
memory. This messages indicates that the read did not work 
correctly. 

IRWIN:ERROR:Tape is not formatted. 

The tape must be formatted before use. 

IRWIN:ERROR:Tape is write protected. 

The write protect tab must be removed for use. 

IRWIN:ERROR:Cannot write to DC1000 cartridge. 

Only Irwin model 110 or 125 drives can write to DC1000 car¬ 
tridges. 

IRWIN.ERROR.Not enough memory for mini-cartridge; retrying... 

The Irwin is waiting for enough user memory to become avail¬ 
able to use the device. 

IRWIN:ERROR:Not enough memory for mini-cartridge; open failed. 
The Irwin did not get enough memory to be able to use the dev¬ 
ice after several retries. 

IRWIN:ERROR:Tape write error. 

A write attempt was unsuccessful for an unknown reason. 

IRWIN:ERROR:Tape verify error. 

A verify attempt was unsuccessful for an unknown reason. 

IRWIN:ERROR:Tape read error. 

A read attempt was unsuccessful for an unknown reason. 

IRWIN:ERROR:Tape uncorrectable ECC error. 

An uncorrectable ECC memory error has occurred, check your 
hardware for defective chips. 

IRWIN:ERROR:Cannot format DC1000 cartridge. 

Only Irwin model 110 or 125 drives can write to DC 1000 car¬ 
tridges. 
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IRWIN:ERROR:Bad state:««m 

Unknown state in the interrupt routine. 

IRWIN:ERROR:DMA boundary error - start address:mwi ending 
addressmwm 

Device tried to transfer data from a buffer that crosses a o4k 
boundary. 


Cartridge Driver Messages 

CT:ERROR:Tape controller (type-name) not found 

The controller specified in in the file lusr/sysliolctconf.asm was 
not found. 

CT:ERROR:Cartridge tape is write protected 

You must remove the write protect tab from the cartridge before 
use. 

CT:ERROR:system too busy for efficient tape use 

There is not enough user memory available to allow the device 
to work. 

CT:WARNING:attempted to free invalid buffer 

The driver attempted free a buffer that was not active. The buffer 
must be activated before use. 


SCSI Driver Messages 

scsi:ERROR:No controller response :num 

Requested controller is not present on SCSI bus num. Check 
your system setup and connections. 

scsi:ERROR:CTLR num LUN num not attached 

Requested unit not present on controller. Check your system 
setup. 

scsi:ERROR:CTLR num LUN mini: invalid type <num>, 

Requested unit is not a disk or tape. Disk and tape and printer 
are currently the only supported SCSI devices. 

scsi:ERROR:CTLR num LUN n«m:device not ready, ctlr, x); 
Requested device is busy. 

scsi:ERROR:adstrategy:device/type error Oxtype/Oxtype 

Internal error - open device is not disk, tape or printer. 

scsi:ERROR:adioctl:ADMODESENSE rc num host num unit num 
ioctl sense command did not complete as expected. 
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scsi:WARNING:adioctl:ADEXECUTE rc num host num unit num 
ioctl execute command did not complete as expected. 

scsi:INFO:adioctl :num reassigned 

ioctl bad block mapping completed (done in pairs) 

scsi:WARNING:adsetparam:ADMODESENSE rc num host num unit 
num 

Mode sense command did not complete as expected. 

scsi:ERROR:adgetcdb:unsupported command num 
Internal error - unexpected command. 

scsi:WARNING:adintr:adapter num SR_DETECTED status=Aiwm, 
int r=num 

SCSI reset detected. 

scsi:WARNING:Unexpected MBI status num 
Unexpected condition after interrupt. 

scsi:WARNING:ad_sndcmd:unexpected port status = num 
Unable to send command to adapter. 

scsi:ERROR:adpresent:Adapter num internal failure: num 
Adapter returned bad status on initialization. 

scsi:ERROR:on disk d ev=num/num ha —num id=num hm=num 
block =num sector -num, cylinder/head = num/num 
Disk I/O failure. 

scsi:ERROR:on tape ha=num id =num lun =num hst num ust num 
AHA-1540 cmd :num [num ...] 

AHA-1540 sense :num [num ...] 

Tape I/O failure; followed by one of these messages: 

end of tape 

tape is write protected 
wrong record length 


Disk Driver Messages 

disk:ERROR:Diskinfo table overflow 

Too many disk drives in use - reconfigure kernel to increase the 
available number of disks. 

disk:ERROR:Invalid partition sector on hard disk 

Master boot block on disk is unrecognizable. Run fsck(ADM). 
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Floppy Driver Messages 

floppy:WARNING:CMOS indicates no diskette drives installed 
Configuration memory invalid - run your DOS SETUP disk. 

floppy: WARNING:CMOS indicates diskette drive mm not present 
Configuration memory invalid - run your DOS SETUP disk. 

floppy:ERROR:fd/mm being formatted 
The floppy drive is in use. 

floppy:ERROR:disk is write protected 

The disk cannot be written because it is protected. 

floppy:ERROR:on dev ( num/num ), block=mtm cmd =num status =num 
Floppy I/O failure, possibly followed by the message: 
insert disk or close floppy door 
if appropriate. 

floppy:WARNING:cmd result error 
I/O error on the floppy drive. 


VPIX Messages 

VPIXxommand completed unexpectedly 
Process terminated prematurely. 


OMTI Driver Messages 

omti:ERROR:cannot allocate a GDT descriptor 

Internal error - kernel dscralloc routine failed. 

omti:ERROR:unit=n«/n controller not configured 

Internal error - driver open failed to identify disk type. 

omti:WARNING:already busy 

Internal error - omtistart called for a busy drive. 

omti:ERROR:unknown command(num), bp->b_cmd 

Internal error - omtistart encountered an unrecognized com¬ 
mand. 

omti:ERROR:command setup failed 

Controller failed to accept command. 

omti:WARNING:non-omti interrupt (num), omti_status 

Controller did not signal an interrupt when an interrupt was 
received. 
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omti: WARNING:unexpected omti interrupt (num), omti_status 

Internal error - no pending command when interrupt received. 

omti:WARNING:still busy 

Controller still busy after generating an interrupt. 

omti:ERROR:during omti_sense 

Interrupt received during an OMTI sense command. 

omti:ERROR:initialization failure 

Error indicated during an initialization. 

omti:ERROR:sense command setup failed 

Controller failed to accept setup command. 

omti.ERROR.minor=«nm, block =num, errtype=nnwi, cod e=num, 
umt=num [sector=n«m, cylinder/head=n«m/«nm, ] <message> 
Disk I/O failure. <message> is one of: 

No error or no sense information, 

No Index, 

No Seek/Command Complete, 

Write/Drive Fault, 

Drive Not Selected/Not Ready, 

No Track zero or Cylinder zero found, 

Multiple Drives Selected, 

Seek/Command in progress, 

Cartridge Changed 
IDCRC, 

Uncorrectable Data ECC, 

ID Address Mark Not Found, 

Data Address Mark Not Found, 

Sector Not Found, 

Seek Error, 

Sequence/DMA, 

Write Protected, 

Correctable ECC, 

Bad Track Encountered, 

Illegal Interleave Factor, 

Unknown Error, 

Ilegal Access To An Alternated Track/Unable to Read the Alternate 
Track Address, 

Alternate of Bad Track Already Assigned, 

No Alternate Track Found, 

Illegal Alternate Track Address 
Invalid Command, 

Illegal Disk Address, 

Illegal Function for Drive Type, 

Volume Overflow 
RAM error, 

EPROM Checksum/Intemal Diagnostic error 
Error with unknown type or code 
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omti:ERROR:controlJer already in select state 

Internal error - controller busy when sending command. 

omti:ERROR:cannot enter command phase 

Controller failed to accept select command. 

omti:ERROR:C_D bit stuck off 

Controller failed to indicate readiness for command. 

omti:ERROR:OMTI_BUSY bit still stuck on 
Controller failed to obey reset command. 

omti:INFO:unloading all requests 

Preparing for manual reset because programmed reset did not 

work. 

omti:WARNING:colliding polling routines ... 

Internal error - multiple instances of omtipoll. 

omti:ERROR:timed out 

Expected interrupt did not arrive. 

omti:ERROR:please use sfmt to modify disk parameters _^ Te „ 

Attempt to write disk characteristics directly with DIOWDISK 
ioctl. 


Serial Driver Messages 

serial:ERROR:Garbage or loose cable on dev num, port shut down 

Too many interrupts were received together. Check your con¬ 
nections. 


Winchester Driver Messages 

wd:ERROR:on fixed disk d ev=num/num block=num cmd=num 
status =num sector=/i«/n, cylinder/head = num/num 
Disk I/O failure. 


Event Driver Messages 

event:ERROR:event channel full 

There are no more devices available in the event queue. 


event:ERROR:event table full 

All of the system’s event queues are opened. 


March 15,1989 


MESSAGES-23 






MESSAGES (M) 


MESSAGES(M) 


Keyboard Driver Messages 

kb:ERROR:keyboard is in an unknown mode 

The keyboard has been set in an invalid mode through an ioctlQ. 
The only valid keyboard modes are XT (0) and AT(1). 


Notes 


Not all messages appear on all machines. Some messages are proces¬ 
sor dependent. 
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mestbl __ h _ 

create a messages locale table 

Syntax 

mestbl [ specfile ] 

Description 

The utility mestbl is provided to allow LC_MESSAGES locales to be 
defined. It reads in a specification file (or standard input if specfile is 
not defined), containing a definition for a particular locale’s response 
strings to yes/no queries, and produces a concise format table file, to 
be read by setlocale( S). 

The response strings may be specified as a string held within double 
quotes or as a series of characters which are specified in one of six dif¬ 
ferent ways (the following examples all specify the ASCII character 
’A’): 


65 - decimal 

0101 - octal 

0x41 -hexadecimal 

’A’ - quoted character 

M01’ - quoted octal 

’\x41’ - quoted hexadecimal 

or a combination of both methods, for example: 
’y’ "es" 


is identical to: 


"yes" 

To specify the response strings, the above string definitions must be 
preceded by the keyword YESSTR= for affirmative responses, and 
NOSTR= for negative responses. 

All characters following the hash character are treated as a comment 
and ignored up to the end of the line, unless the hash is within a 
quoted string. 

The concise format locale table is placed in a file named messages in 
the current directory. This file should be copied or moved to the 
correct place in the setlocale{ S) file tree (see locale (M)). To prevent 
accidental corruption of the output data, the file is created with no 
write permission; if the mestbl utility is run in a directory containing a 
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write-proteetecJ “messages” file, the utility will ask if the existing file 
should be replaced - any response other than “yes” or “y” will cause 
mestbl to terminate without overwriting the existing file. 

See Also _ 

s0fiocale(S) mOntbl ^’ Coltb1 ^’ locaIe (M), numtbl(M), timtbl(M), 

Diagnostics 


All error messages printed are self explanatory. 

Value Added 


mestbl is an extension of AT&T System V 
Operation. 


provided by the Santa Cruz 
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montbl __ 

create a currency locale table 


Syntax 

montbl [ specfile ] 

Description 

The utility montbl is provided to allow new LC_MONETARY locales 
to be defined; it reads a specification file, containing a definition ot 
the currency symbol for a particular locale, and produces a binary 
table file, to be read by setlocale (S), which determines the behavior ot 
the nljanginfo (S) routine. 

The information supplied in the specification file consists of a line in 
the following format: 

CRNCYSTR = string 

The “ = ” can be separated from the keyword and string fields by 
zero or more space or tab characters. 

The string is a sequence of characters surrounded by quotes (")• The 
first character of the string should be if the symbol is to precede 
the currency value, or “+” if it should appear after the value. Charac¬ 
ters within the string can be specified both literally and usmg \ 
escapes; the following three strings are equivalent: 

"+DM" literal 

"+\x44M" hexadecimal escapes 

"+D\115" octal escapes 

All characters following a hash ( # ) are treated as a comment and 
ignored up to the end of the line, unless the hash is within a quoted 
string. 

The binary table output is placed in a file named currency , within the 
current directory. This file should be copied or linked to the correct 
place in the setlocale file tree (see locale (M)). To prevent accidental 
corruption of the output data, the file is created with no write permis¬ 
sion; if the montbl utility is run in a directory containing a wnte- 
nrotected currency file, the utility will ask if the existing file should be 
replaced - any response other than “yes” or “y” will cause montbl to 
terminate without overwriting the existing file. 
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If the specfile argument is missing, the specification information is 
read from the standard input. 

See Also 


chrtbl(M), locale(M), msgtbl(M), nl_langinfo(S), numtbl(M), 
setlocale(S), timtbl(M) 

Diagnostics 


If the input table file cannot be opened for reading, processing will ter¬ 
minate with the error message, “Cannot open specification file’’. 

Any lines in the specification file which are syntactically incorrect, or 
contain an unrecognized value instead of CRNCYSTR will cause an 
error message to be issued to the standard error output, specifying the 
line number on which the error was detected. The line will be 
ignored, and processing will continue. 

If the output file, currency , cannot be opened for writing, processing 
will terminate with the error message, “Cannot create table file”. 

Any error conditions encountered will cause the program to exit with 
a non-zero return code; successful completion is indicated with a zero 
return code. 

Value Added 


montbl is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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mscreen_ 

serial multiscreens utility 

Syntax 

mscreen [ -s ] [ -n number ] [ -t ] 

Description 

mscreen allows a serial terminal to have multiple login screens similar 
to the multiscreen^ M) console. 

Note: For full mscreen support the terminal must have the ability to 
switch internal screen pages on command and it must retain a separate 
cursor position for each screen page. 

The options are used as follows: 

-s Silent mode. This flag suppresses the startup messages, 

and on “dumb” terminals it suppresses the screen switch 
messages 

-n Selects the number of serial multiscreens desired up to the 

maximum defined for the terminal type. 

-t Disables the transparent tty checking, mscreen nonnally 

exits silently if the terminal device name starts with the 
characters “ttyp”. Device names beginning with “ttyp” 
are used as slave devices for mscreen. The correct names 
for the master tty devices begin with “ptyp”. 

mscreen can be used on both “smart” and “dumb” terminals. 
Although it is optimized to take advantage of smart terminals with 
screen memory, mscreen also works on dumb terminals, although the 
screen images are not saved during screen changes, mscreen also sup¬ 
ports terminals with two (or more) serial ports that are connected to 
different computers. 

mscreen is designed to be invoked from the .profile or .login files. Use 
mscreen in place of the SHELL variable so that serial multiscreens 
can be automatic at login time. The “stop” and “quit” keys allow 
you to logout from all screens with a single keystroke. 

Configuration 

mscreen determines the terminal type of the terminal it is invoked 
from by examining the environment variable TERM, mscreen looks 
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The pseudo terminals assigned to the user are automatically deter¬ 
mined at startup by mscreen. Manual assignment of ttys can be 
accomplished by creating a file in the user’s home directory called 
.mscreenrc. 


mscreencap format 


mscreencap contains an entry for each terminal type supported. An 
entry may have several names if the support for several terminal types 
are the same. Within an entry are the key mappings for each potential 
pseudo terminal. Each pseudo terminal has a help key string, an input 
string (the sequence generated by the key that selects this screen), and 
an optional output string (the sequence to send to the terminal that 
will cause a page switch). The input and output strings are in a 
termcap like format: (the backslash and caret are special lead in 
(escape) characters) 

\nnn an octal number, one to three digits are allowed 

\n newline 

\r carriage return 

\t tab 

\b backspace 

\f form feed 

\E escape (hex lb octal 33). 

\ enter backslash as a data character 

V enter caret as a data character 

VX ctrl-X where X can be: @ABCDEFGHUKLM- 
NOPQESTUVWXYZ[]~_ effectively the caret 
can generate hex 01 through hex If. 

If a terminal type has no output strings then it is assumed to be a dumb 
terminal that does not have multiple internal memory pages. 

There are five special entries that allow the user to define keys to sup¬ 
port the other functions of mscreen. They are the help key (which 
prints a list of all of the keys that are currently available and their 
functions), the who key (prints the name of the current screen), the 
stop key (terminates mscreen and returns a good (zero) shell return 
code), and quit key (terminates mscreen and returns a bad (non-zero) 
shell return code and the dummy entry that is used for terminals with 
multiple ports. 
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The format is: 

#this is a comment and may only appear between entries 
entryname|aliasl|aliasl... Ialiasn: 

: specialname, helpname, inputstring, pageselectstring: 

: specialname, helpname, inputstring,pageselectstring: 
entryname|aliasl|aliasl... Ialiasn: 

: specialname, helpname, inputstring, pageselect string. 

: specialname, helpname, inputstring, pageselectstring: 

The specialname is empty for real screen entries. See the provided 
/etc/mscreencap for examples. 


.mscreenrc format 

.mscreenrc contains a list of ttynames if the user wants to allocate a 
fixed set of ttys for use: 


ttypO 

ttypi 

ttypn 


Shell return codes and auto login/logout 

mscreen exits with a bad (non-zero) return code if there is an error or 
when the “quit” key is pressed. The “stop” key causes mscreen to 
exit with a good (zero) return code. This allows users to place mscreen 
in the .login or .profile files. The .login or .profile files should set up an 
automatic logout if the mscreen return code is good (zero). The fol¬ 
lowing is a csh sample invocation of mscreen for a .login file: 

mscreen -n 4 
if ($status == 0) logout 

The single key logout feature of mscreen works as if a normal logout 
was entered on each pseudo-terminal. A hangup signal is sent to all of 
the processes on all the pseudo terminals. 


Multiple Port Option 

mscreen provides a dummy entry type. It allows mscreen to be placed 
in an inactive state while the user uses his terminal to converse 
through another (physical) io port to another computer, see the pro¬ 
vided /etc/mscreentermmap for an example. To be used, you must 
take the example and configure it for your needs. 
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mscreen Driver 

The mscreen driver is already installed in the UNIX kernel with eight 
pseudo terminals available for use. You must enable a pseudo termi¬ 
nals to use it. See the link-kit instructions for relinking the kernel to 
have more available pseudo terminals. 

Notes 


mscreen has a VTIM timeout of 1/5 second for input strings. 

mscreen has a limit of twenty multiscreens per user. 

You should not switch screen pages in mscreen when output is occur¬ 
ring because if an escape sequence is cut in half it may leave the ter¬ 
minal in an indeterminate state and distort the screen image, 

Terminals that save the cursor location for each screen often do not 
save states such as insert mode, inverse video, and others. For exam¬ 
ple, you should not change screens if you are in insert mode in vi, and 
you should not change screens during an inverse video output 
sequence. 

For inactive screens (screens other than the current one) mscreen 
saves the last 2048 characters of data (2K). Data older than this is 
lost. This limit occasionally results in errors for programs that require 
a memory of more data than this. The user-defined screen redraw key 
restores the screen to normal appearance. 

mscreen depends on the pseudo terminal device names starting with 
ttyp for the slave devices and ptyp for the master devices. The number 
of trailing character in the device name is not significant. 


See Also 


multiscreen(M), enable(C), “Adding Ports, Terminals, and Modems” 
in the System Administrator’s Guide 

Value Added 


mscreen is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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multiscreen _ 

multiple screens (device files) 

Syntax 


alt-Fn 

alt-ctrl-Fn 

alt-shift-Fn 

alt-ctrl-shift-Fn 

Description 

With the multiscreen feature, a user can access up to twelve different 
“screens,” each corresponding to a separate device file. Each screen 
can be viewed one at a time through the primary monitor video 
display. 

The number of screens on a system depends upon the amount of 
memory in the computer. The system displays the number of enabled 
screens during the boot process. 

Access 


To see the next consecutive screen, enter: 

Ctrl-PrtSc 

To move to any screen from any other screen, enter: 

alt-Fn or alt-ctrl-Fn or alt-shift-Fn 
alt-Fn or alt-ctrl-Fn (screens 1-12) 
alt-shift-Fn or alt-ctrl-shift-Fn (screens 11-16,7-12) 

where n is the number of one of the “F” function keys on the primary 
monitor keyboard. For example: 

alt-F2 

selects tty02, and all output in that device’s screen buffer is displayed 
on the monitor screen. 

The second form (using the SHIFT key) permits access to screens 11 
and 12 on keyboards that have only ten function keys. It is also possi¬ 
ble to configure the kernel for up to 16 screens, but 12 is the default. 
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The function key combinations used to display the various screens are 
defined in the keyboard mapping file. The /usr/lib/keyboard/keys or 
other map key (ADM) file can be modified to allow different key com¬ 
binations to change multiscreens. Use the mapkey utility to create a 
new keyboard map. 

Files 


/dev/tty [01-12] multiscreen devices 

(number available depends on system 
memory) 

See Also 

mapkey(ADM), keyboard(HW), screen(HW), serial(HW), stty(C) 

Notes 


Any system error messages are normally output on the console device 
file (/dev/console). When an error message is output, the video 
display reverts to the console device file, and the message is displayed 
on the screen. The console device is the only teletype device open 
during the system boot sequence and when in single user, or system 
maintenance mode. 

Limitations to the number of multiscreens available on a system does 
not affect the number of serial lines or devices available. See 
serial{ M) for information on available serial devices. 

Note that the keystrokes given here are the default, but your keyboard 
may be different. If so, see keyboard( M) for the appropriate substi¬ 
tutes. Also, any key can be programmed to generate the screen 
switching sequences by using the mapkey utility. 

Value Added 


multiscreen is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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numtbl_ 

create a numeric locale table 

Syntax 

numtbl [ table_file ] 

Description 

This utility will create a numeric locale table to be interpreted by the 
setlocale (S) system call. 

The table Jile contains information about the numeric locale in a user 
readable form. 

At present, two pieces of information can be supplied. These are: the 
character to be used as a decimal place marker (radix character), and 
the character to be used as a thousands delimiter, for example the 
commas in 1,000,000. To specify these, there must be lines, in the 
table file, of the form: 

DECIMAL=d 

THOUSANDS=t 

Where “d” is the character to be used as the decimal place mark and 
“t” is the character to be used as the thousands delimiter. The char¬ 
acters “d” and “t” may be specified in six different ways. The fol¬ 
lowing lines show different formats for the letter b. 


98 

- decimal 

0142 

- octal 

0x62 

- hexadecimal 

’b’ 

- quoted character 

’\0142’ 

- quoted octal 

’\x62’ 

- quoted hexadecimal 


Any line starting with a hash (“#”) is treated as a comment. 

The output is a file, called numeric , which is placed in the current 
directory. This file is in a form which can be interpreted by the 
setlocale(S) system call. For more information on where this file 
should be placed, please see locale(M). 

If no table file is specified, the information is taken from the standard 
input. The format of the information is identical. 
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If either DECIMAL or THOUSANDS is not specified, its value will 
default to or respectively. 

See Also 


locale(M), environ(M) 

Diagnostics 


Any lines of input which are in the wrong format will cause a warning 
to be issued on the terminal, but will not terminate the program. 

“Character syntax error” will be issued on the terminal if the format 
of the character specification does not match one of those specified 
above. The program will then terminate. 

If the input table file cannot be opened for reading, the program will 
also terminate with the error message, “Cannot open table file”. 

If the output file, numeric, cannot be opened for writing, the program 
will terminate with the eiror message, “Cannot create numeric locale 
file . 


Notes 


The thousands delimiter is not currently used within any of the stan¬ 
dard UNIX libraries or utilities, although it can be accessed by appli¬ 
cation programs using the nl_langinfo(S ) function. 

The string RADIXCHAR may be used as an alternative to DECIMAL 
and THOUSEP as an alternative to THOUSANDS , if required. These 
alternatives are provided for consistency with the identifiers used by 
nl_langinfo(S). 

Value Added 


numtbl is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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prof _ 

profile within a function 

Syntax 


#define MARK 
#include <prof.h> 

void MARK (name) 

Description __ 

MARK will introduce a mark called name that will be treated the same 
as a function entry point. Execution of the mark will add to a counter 
for that mark, and program-counter time spent will be accounted to the 
immediately preceding mark or to the function if there are no preced¬ 
ing marks within the active function. 

Name may be any valid C identifier. Each name in a single compila¬ 
tion must be unique, but may be the same as any ordinary program 
symbol. 

For marks to be effective, the symbol MARK must be defined before 
the header file <prof.h> is included. This may be defined by a prepro¬ 
cessor directive as in the synopsis or by a command line argument, i.e: 

cc -p -DMARK foo.c 

If MARK is not defined, the MARK( name) statements may be left in 
the source files containing them and will be ignored. 
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Examples 


PROF(M) 


In this example, marks can be used to determine how much time is 
spent in each loop. Unless this example is compiled with MARK 
defined on the command line, the marks are ignored. 

#include <prof.h> 
foo( ) 

{ 

int i, j; 


MARK(loopl); 

for (i = 0; i < 2000; i++) { 

} 

MARK(loop2); 

for (j =0; j < 2000; j++) { 

} ' 

} 

See Also 


prof(C), profil(S), monitor(S) 
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profile_ 

sets up an environment at login time 

Description 

The optional file, .profile, permits automatic execution of commands 
whenever a user logs in. The file is generally used to personalize a 
user’s work environment by setting exported environment variables 
and terminal mode (see environ (M)). 

When a user logs in, the user’s login shell looks for .profile in the 
login directory. If found, the shell executes the commands in the file 
before beginning the session. The commands in the file must have the 
same format as if they were entered at the keyboard. Any line begin¬ 
ning with the number sign (#) is considered a comment and is ignored. 
The following is an example of a typical file: 

# Tell me when new mail comes in 
MAIL=/usr/mail/myname 

# Add my /bin directory to the shell search sequence 
PATH=$PATH:$HOME/bin 

# Make some environment variables global 
export MAIL PATH TERM 

# Set file creation mask 
umask 22 

Note that the file /etc/profile is a system-wide profile that, if it exists, 
is executed for every user before the user’s .profile is executed. 

Files 


$HOME/.profile 

/etc/profile 

See Also 


env(C), login(M), mail(C), sh(C), stty(C), su(C), environ(M) 
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promain, nopromain _ 

restrict the execution domain of a program 

Syntax 


auths -r nopromain 

Description 


The promain feature allows you to control the damage an SUID pro- 
. can d° t0 your files. An SUID program starts execution with 
effective user ID equal to the owner of the SUID program file and real 
user ID equal to die invoker of the SUID program. On traditional 
UNIX systems, an SUID program has complete access to all files, 
processes, and IPC objects (collectively called resources ) to which 
the invoker or the owner has access, because the program can use 
setuid (S) to switch between the invoker and owner user ID. Outside a 
promain, this power is restricted to resources to which the invoker and 
the owner have access, as described in this section. 

The SUID feature is used when one user (or system function) needs to 
protect files from access except through a well-defined set of pro¬ 
grams. An example is the suite of line printer commands, which work 
with a set of configuration files, status files, and shell scripts to keep 
track of which print jobs are queued to which printers. Users and line 
printer administrators use several commands to submit and cancel 
jobs, change and query the status of printers, and add and remove 
printers from the system or from active duty. All printer files are 
owned by the pseudo user lp , the user ID which is the owner of all 
files used by the line printer subsystem, including the printer special 
devices themselves. 

When you invoke the lp (C) command to print a file, the program can 
access the files in the database, but can also access files that you 
request to be printed because the program can setuid to your user ID to 
access your files. A malicious Ip program could just as easily look for 
protected files in your directory hierarchy and copy them to a place 
protected such that only lp could read them. Thus, the fact that you 
trust Ip enough to run it as a program means that you trust that it will 
not abuse the power you give when you run it. 

If you run a SUID program on a trusted system and the promain ker¬ 
nel authorization is off, a promain is created, and the current directory 
is noted as the promain root . Files in the subtree starting at the 
promain root are said to be inside the promain, while files outside that 
subtree are said to be outside the promain. Promains protect a user 
against a malicious SUID program by restricting the kinds of accesses 
the program can do outside the promain when running as you (the 
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invoker). When running with the invoker’s effective user ID outside 
the promain, the program can access files if both the invoker and the 
owner have access (public files). Inside the promain, the program has 
access according to the rules associated with normal UNIX systems. 

To run untrustworthy SUID programs with promain protection, do the 
following: 

1. Start a subshell without the nopromain authorization, as in this 
example: 

$ auths 

Kernel authorizations: nopromain,execsuid 

$ auths -r nopromain 
$ auths 

Kernel authorizations: nopromain 

2. Change directory to one in which you will place all files which you 
expect the program to modify, and put all the files the program 
needs there, as in the following example: 

$ cd tmp 

$ cp path/filel path/file2 
$ Is -Id . filel file2 

total 10 

drwxrwx- 2 drb mktng 64 Jul 30 07:53 . 

-rw-rw- 1 drb mktng 10345 Jul 30 07:52 filel 

-rw-rw- 1 drb mktng 9200 Jul 30 07:52 filel 

$ pwd 

/usr/drb/tmp 

3. Run the program. In /usr/drb/tmp , the program has complete 
access to filel , file2 , and the /usr/drb/tmp directory. Assuming 
that all files owned by drb outside the /usr/drb/tmp directory are 
protected, the program has access only if drb allows public access. 

Note that promain protection is enforced for all system actions outside 
the promain when running under the effective user ID of the invoker. 
The program cannot read or write files unless they are accessible to 
the program owner and the invoker. The program cannot use 
chown(S) or chmod(S ) on files outside the promain as drb because 
drb and the SUID program owner cannot possibly both own the file 
unless drb is the program owner as well. In addition, the program 
cannot link files outside the promain to a file inside the promain unless 
the file is accessible to bot the invoker and the owner. This protects 
against a malicious program getting around promain protection by 
changing the search path used to access the file. 


What Promains Guard Against 

Promains were designed to guard against one specific type of Trojan 
Horse attack, where another user supplies you with a SUID program 
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which steals some of your files into a location or directory to which 
you do not have access. It also stops the common case of creating a 
program which is SUID to your user ID by using setuid(S ) to: 

1. Set the program’s effective user ID to you (the real user ID), 

2. Create a file (which sets you as the owner), and 

3. Change the program’s mode such that the SUID bit is on. 

Promains stop these attacks by only allowing file creation if both the 
invoker and the program owner are allowed an action. Thus, the pro¬ 
gram will only be able to access your public files (world or group 
readable) and will never be able to use the SUID attack to create a 
malicious program (e.g., a shell) which is SUID to you. If your file 
hierarchy is suitably protected, you can stop attempts to steal data or 
create damaging files (e.g., programs which have the same name as 
system programs which you execute because you have included the 
current directory in your search path). 


What Promains Do Not Guard Against 

Promains do not protect against running a SUID program which has 
access to public files or directories in your hierarchies. Neither do 
they protect against Trojan Horses which are not SUID. A program 
which is not SUID is effectively given access to any objects to which 
you have access. Thus, running a program which you do not trust is in 
effect giving your entire discretionary capability to that process. 
Always suspect a program which is given to you from someone whose 
motives you have no reason to trust. The newspapers today are full of 
stories of Trojan Horses and computer viruses (one special case of a 
Trojan Horse) which were planted by someone who was able to 
arrange for a user to run a program which did something malicious. 

See Also 


auths(C), “Maintaining System Security” in the System 
Administrator’s Guide 
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rmb _ 

remove extra blank lines from a file 

Syntax 

/usr/bin/rmb 

Description 


/usr/bin/rmb acts as a filter to remove any series of blank lines 
greater than two lines in length. This means that all long sequences of 
blank lines will be reduced to two blank lines. This is particularly 
useful for cleaning nroff(CT) output of blank lines before putting the 
output in a file. 

See Also 


nroff(CT), man(C) 

Notes 

Because /usr/bin/rmb is a filter, it must be used within a piped com¬ 
mand sequence as shown in the following examples: 

cat infile I /usr/bin/rmb > outfile 

nroff infile I /usr/bin/rmb > outfile 

It cannot be used in the form /usr/bin/rmb filename. 
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streamio 

STREAMS ioctl commands 


Syntax 


#include <stropts.h> 

int ioctl (fildes, command, arg) 

int fildes, command; 


Description 



STREAMS [see intro(S )] ioctl commands are a subset of ioctl(S) sys¬ 
tem calls which perform a variety of control functions on streams. 
The arguments command and arg are passed to the file designated by 
fildes and are inteipreted by the stream head. Certain combinations of 
these arguments may be passed to a module or driver in the stream. 

fildes is an open file descriptor that refers to a stream, command 
determines the control function to be performed as described below. 
arg represents additional information that is needed by this command. 
The type of arg depends upon the command, but it is generally an 
integer or a pointer to a command- specific data structure. 

Since these STREAMS commands are a subset of ioctl, they are sub¬ 
ject to the errors described there. In addition to those errors, the call 
will fail with errno set to EINVAL, without processing a control func¬ 
tion, if the stream referenced by fildes is linked below a multiplexer, 
or if command is not a valid value for a stream. 

Also, as described in ioctl, STREAMS modules and drivers can detect 
errors. In this case, the module or driver sends an error message to the 
stream head containing an error value. This causes subsequent system 
calls to fail with errno set to this value. 

Command Functions 

The following ioctl commands, with error values indicated, are appli¬ 
cable to all STREAMS files: 

I_PUSH Pushes the module whose name is pointed to by arg 

onto the top of the current stream, just below the 
stream head. It then calls the open routine of the 
newly-pushed module. On failure, errno is set to one 
of the following values: 
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I_POP 


I_LOOK 


I_FLUSH 


[EINVAL] Invalid module name. 

[EFAULT] arg points outside the allocated 

address space. 

[ENXIO] Open routine of new module failed. 

[ENXIO] Hangup received on fildes. 

Removes the module just below the stream head of 
the stream pointed to by fildes. arg should be 0 in an 
I_POP request. On failure, errno is set to one of the 
following values: 

[EINVAL] No module present in the stream. 

[ENXIO] Hangup received on fildes. 

Retrieves the name of the module just below the 
stream head of the stream pointed to by fildes, and 
places it in a null terminated character string pointed 
at by arg. The buffer pointed to by arg should be at 
least FMNameSZ+1 bytes long. An [#include 
<sys/conf.h>] declaration is required. On failure, 
errno is set to one of the following values: 

[EFAULT] arg points outside the allocated 

address space. 

[EINVAL] No module present in stream. 

This request flushes all input and/or output queues, 
depending on the value of arg. Legal arg values are: 

FLUSHR Flush read queues. 

FLUSHW Flush write queues. 

FLUSHRW Flush read and write queues. 

On failure, errno is set to one of the following values: 


[ENOSR] Unable to allocate buffers for flush 

message due to insufficient STREAMS 
memory resources. 

[EINVAL] Invalid arg value. 

[ENXIO] Hangup received on fildes. 
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I-SETSIG Informs the stream head that the user wishes the ker¬ 
nel to issue the SIGPOLL signal [see signal^ S) and 
sigset( S)] when a particular event has occurred on the 
stream associated with fildes. I_SETSIG supports an 
asynchronous processing capability in STREAMS. 
The value of arg is a bitmask that specifies the events 
for which the user should be signaled. It is the 
bitwise-OR of any combination of the following con¬ 
stants: 


SJNPUT A non-priority message has arrived on 
a stream head read queue, and no 
other messages existed on that queue 
before this message was placed there. 
This is set even if the message is of 
zero length. 


S_HIPRI A priority message is present on the 
stream head read queue. This is set 
even if the message is of zero length. 

S_OUTPUT The write queue just below the stream 
head is no longer full. This notifies 
the user that there is room on the 
queue for sending (or writing) data 
downstream. 


S_MSG A STREAMS signal message that con¬ 

tains the SIGPOLL signal has reached 
the front of the stream head read 
queue. 

A user process may choose to be signaled only of 
priority messages by setting the arg bitmask to the 
value S_HIPRI. 

Processes that wish to receive SIGPOLL signals must 
explicitly register to receive them using I_SETSIG. If 
several processes register to receive this signal for the 
smie event on the same Stream, each process will be 
signaled when the event occurs. 

If the value of arg is zero, the calling process will be 
unregistered and will not receive further SIGPOLL sig¬ 
nals. On failure, errno is set to one of the following 
values: 

[EINVAL] arg value is invalid or arg is zero and 
process is not registered to receive the 
SIGPOLL signal. 
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IJ3ETSIG 


IJFTND 


I_PEEK 


[EAGAIN] Allocation of a data structure to store 
the signal request failed. 

Returns the events for which the calling process is 
currently registered to be sent a SIGPOLL signal. The 
events are returned as a bitmask pointed to by arg, 
where the events are those specified in the description 
of I_SETSIG above. On failure, errno is set to one of 
the following values: 

[EINVAL] Process not registered to receive the 
SIGPOLL signal. 

[EFAULT] arg points outside the allocated 
address space. 

Compares the names of all modules currently present 
in the stream to the name pointed to by arg , and 
returns 1 if the named module is present in the stream. 
It returns 0 if the named module is not present. .On 
failure, errno is set to one of the following values: 

[EFAULT] arg points outside the allocated 
address space. 

[EINVAL] arg does not contain a valid module 
name. 

Allows a user to retrieve the information in the first 
message on the stream head read queue without taking 
the message off the queue, arg points to a strpeek 
structure which contains the following members: 

struct strbuf ctlbuf; 
struct strbuf databuf; 
long flags; 

The maxlen field in the ctlbuf and databuf strbuf struc¬ 
tures [see getmsg(S)] must be set to the number of 
bytes of control information and/or data information, 
respectively, to retrieve. If the user sets flags to 
RS_HIPRI, IJPEEK will only look for a priority mes¬ 
sage on the stream head read queue. 

I_PEEK returns 1 if a message was retrieved, and 
returns 0 if no message was found on the stream head 
read queue, or if the RS.HIPRI flag was set in flags 
and a priority message was not present on the stream 
head read queue. It does not wait for a message to 
arrive. On return, ctlbuf specifies information in the 
control buffer, databuf specifies information in the 
data buffer, and flags contains the value 0 or 
RS_HIPRI. On failure, errno is set to one of the 
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I_SRDOPT 


LGRDOPT 


I_NREAD 


I_FDINSERT 


following values: 

[EFAULT] arg points, or the buffer area specified 
in ctlbuf or databuf is, outside the 
allocated address space. 

[EBADMSG] Queued message to be read is not 
valid for I_PEEK 

Sets the read mode using the value of the argument 
arg. Legal arg values are: 

RNORM Byte-stream mode, the default. 

RMSGD Message-discard mode. 

RMSGN Message-nondiscard mode. 

Read modes are described in read( S). On failure, 
errno is set to the following value: 

[EINVAL] arg is not one of the above legal 
values. 

Returns the current read mode setting in an int pointed 
to by the argument arg. Read modes are described in 
read( S). On failure, errno is set to the following 
value: 

[EFAULT] arg points outside the allocated 

address space. 

Counts the number of data bytes in data blocks in the 
first message on the stream head read queue, and 
places this value in the location pointed to by arg. 
The return value for the command is the number of 
messages on the stream head read queue. For exam¬ 
ple, if zero is returned in arg , but the ioctl return value 
is greater than zero, this indicates that a zero-length 
message is next on the queue. On failure, errno is set 
to the following value: 

[EFAULT] arg points outside the allocated 

address space. 

Creates a message from user specified buflfer(s), adds 
information about another stream and sends die mes¬ 
sage downstream. The message contains a control 
part and an optional data part. The data and control 
parts to be sent are distinguished by placement in 
separate buffers, as described below. 
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arg points to a strfdinsert structure which contains the 
following members: 

struct strbuf ctlbuf; 
struct strbuf databuf; 
long flags; 

int fildes; 

int offset; 

The len field in the ctlbuf strbuf structure [see 
putmsg( S)] must be set to the size of a pointer plus die 
number of bytes of control information to be sent with 
the message, fildes in the strfdinsert structure 
specifies the file descriptor of the other stream, offset , 
which must be word-aligned, specifies the number of 
bytes beyond the beginning of the control buffer where 
L.FDINSERT will store a pointer. This pointer will be 
the address of the read queue structure of the driver 
for the stream corresponding to fildes in the strfdinsert 
structure. The len field in the databuf strbuf structure 
must be set to the number of bytes of data information 
to be sent with the message or zero if no data part is to 
be sent. 

flags specifies the type of message to be created. A 
non-priority message is created if flags is set to 0, and 
a priority message is created if flags is set to 
RS_HIPRI. For non-priority messages, I_FDINSERT 
will block if the stream write queue is full due to 
internal flow control conditions. For priority mes¬ 
sages, I_FDINSERT does not block on this condition. 
For non-priority messages, I_FDINSERT does not 
block when the write queue is full and 0_NDELAY is 
set. Instead, it fails and sets errno to EAGAIN. 

I_FDINSERT also blocks, unless prevented by lack of 
internal resources, waiting for the availability of mes¬ 
sage blocks in the stream , regardless of priority or 
whether O.NDELAY has been specified. No partial 
message is sent. On failure, errno is set to one of the 
following values: 

[EAGAIN] A non-priority message was specified, 
the 0_NDELAY flag is set, and the 
stream write queue is full due to inter¬ 
nal flow control conditions. 

[ENOSR] Buffers could not be allocated for the 
message that was to be created due to 
insufficient STREAMS memory 
resources. 
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I_STR 


[EFAULT] arg points, or the buffer area specified 
in ctlbuf or databuf is, outside the 
allocated address space. 

[EINVAL] One of the following: jildes in the 
strfdinsert structure is not a valid, 
open stream file descriptor; the size of 
a pointer plus offset is greater than the 
len field for the buffer specified 
through ctlptr; offset does not specify 
a properly aligned location in the data 
buffer; an undefined value is stored in 
flags. 

[ENXIO] Hangup received on fildes of the ioctl 
call or jildes in the strfdinsert struc¬ 
ture. 


[ERANGE] The len field for the buffer specified 
through databuf does not fall within 
the range specified by the maximum 
and minimum packet sizes of the top¬ 
most stream module, or the len field 
for the buffer specified through data¬ 
buf is larger than the maximum 
configured size of the data part of a 
message, or the len field for the buffer 
specified through ctlbuf is larger than 
the maximum configured size of the 
control part of a message. 

I_FDINSERT can also fail if an error message was 
received by the stream head of the stream correspond¬ 
ing to fildes in the strfdinsert structure. In this case, 
err no will be set to the value in the message. 

Constructs an internal STREAMS ioctl message from 
the data pointed to by arg and sends that message 
downstream. 

This mechanism is provided to send user ioctl requests 
to downstream modules and drivers. It allows infor¬ 
mation to be sent with the ioctl and will return to the 
user any information sent upstream by the downstream 
recipient. I_STR blocks until the system responds 
with either a positive or negative acknowledgment 
message or until the request "times out" after some 
period of time. If the request times out, it fails with 
errno set to ETIME. 
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At most, one I_STR can be active on a stream. Further 
I_STR calls will block until the active I_STR com¬ 
pletes at the stream head. The default timeout inter¬ 
val for these requests is 15 seconds. The 0_NDELAY 
[see open(S)\ flag has no effect on this call. 


To send requests downstream, arg must point to a 
strioctl structure which contains the following 


members: 

int 

ic_cmd; 

/* 

downstream command 

*/ 

int 

ic_timout; 

/* 

ACK/NAK timeout */ 

*/ 

int 

ic_len; 

/* 

length of data arg 

char 

*ic_dp; 

/* 

ptr to data arg */ 



ic cmd is the internal ioctl command intended for a 
downstream module or driver; and icjimout is the 
number of seconds (-1 = infinite, 0 = use default, >0 = 
as specified) an IJSTR request will wait for ack¬ 
nowledgment before timing out. icjen is the number 
of bytes in the data argument and ic_dp is a pointer to 
the data argument. The icjen field has two uses: on 
input, it contains the length of the data argument 
passed in, and on return from the command, it con¬ 
tains the number of bytes being returned to the user 
(the buffer pointed to by ic_dp should be large enough 
to contain the maximum amount of data that any 
module or the driver in the stream can return). 


The stream head will convert the information pointed 
to by the strioctl structure to an internal ioctl com¬ 
mand message and send it downstream. On failure, 
errno is set to one of the following values: 


[ENOSR] 

[EFAULT] 

[EINVAL] 

[ENXIO] 

[ETIME] 


Unable to allocate buffers for the ioctl 
message due to insufficient STREAMS 
memory resources. 


arg points, or the buffer area specified 
by ic_dp and icjen (separately for 
data sent and data returned) is, outside 
the allocated address space. 


ic len is less than 0 or icjen is larger 
than the maximum configured size of 
the data part of a message or icjimout 
is less than -1. 


Hangup received on fildes. 


A downstream ioctl timed out before 
acknowledgment was received. 
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IJSENDFD 


I_RECVFD 


An I_STR can also fail while waiting for an ack¬ 
nowledgment if a message indicating an error or a 
hangup is received at the stream head. In addition, an 
error code can be returned in the positive or negative 
acknowledgment message, in the event the ioctl com¬ 
mand sent downstream fails. For these cases, I_STR 
will fail with errno set to the value in the message. 

Requests the stream associated with fildes to send a 
message, containing a file pointer, to the stream head 
at the other end of a stream pipe. The file pointer 
corresponds to arg, which must be an integer file 
descriptor. 


I-SENDFD converts arg into the corresponding system 
file pointer. It allocates a message block and inserts 
the file pointer in the block. The user id and group id 
associated with the sending process are also inserted. 
'Dus message is placed directly on the read queue [see 
intro( S)] of the stream head at the other end of the 
stream pipe to which it is connected. On failure, 
errno is set to one of the following values: 


[EAGAIN] 

[EAGAIN] 

[EBADF] 

[EINVAL] 

[ENXIO] 


The sending stream is unable to allo¬ 
cate a message block to contain the 
file pointer. 

The read queue of the receiving 
stream head is full and cannot accept 
the message sent by IJSENDFD. 

arg is not a valid, open file descriptor. 

fildes is not connected to a stream 
pipe. 

Hangup received on fildes. 


Retrieves the file descriptor associated with the mes¬ 
sage sent by an IJSENDFD ioctl over a stream pipe. 
arg is a pointer to a data buffer large enough to hold 
an strrecvfd data structure containing the following 
members: 

int fd; 

unsigned short uid; 
unsigned short gid; 
char fill [8]; 

fd is an integer file descriptor, uid and gid are the user 
id and group id, respectively, of the sending stream. 
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If 0_NDELAY is not set [see open( S)], I.RECVFD will 
block until a message is present at the stream head. If 
0_NDELAY is set, I_RECVFD will fail with errno set 
to EAGAIN if no message is present at the stream 
head. 

If the message at the stream head is a message sent by 
an I_SENDFD, a new user file descriptor is allocated 
for the file pointer contained in the message. The new 
file descriptor is placed in the fd field of the strrecvfd 
structure. The structure is copied into the user data 
buffer pointed to by arg. On failure, errno is set to one 
of the following values: 


[EAGAIN] A message was not present at the 
stream head read queue, and the 
Q_NDELAY flag is set. 


[EBADMSG] The message at the stream head read 
queue was not a message containing a 
passed file descriptor. 

DEFAULT] arg points outside the allocated 
address space. 


[EMFILE] 

[ENXIO] 


NOFiles file descriptors are currently 
open. 

Hangup received on fildes. 


The following two commands are used for connecting and disconnect¬ 
ing multiplexed STREAMS configurations. 

I_LINK Connects two streams, where fildes is the file descrip¬ 

tor of the stream connected to the multiplexing driver, 
and arg is the file descriptor of the stream connected 
to another driver. The stream designated by arg gets 
connected below the multiplexing driver. I_LINK 
requires the multiplexing driver to send an ack¬ 
nowledgment message to the stream head regarding 
the linking operation. This call returns a multiplexer 
ID number (an identifier used to disconnect the multi¬ 
plexer, see IJJNLINK) on success, and a -1 on failure. 
On failure, errno is set to one of the following values: 


[ENXIO] Hangup received on fildes. 

[ETIME] Time out before acknowledgment 

message was received at stream head. 
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LUNLINK 


[EAGAIN] 

Temporarily unable to allocate storage 
to perform the IJLINK. 

[ENOSR] 

Unable to allocate storage to perform 
the IJLINK due to insufficient 
STREAMS memory resources. 

[EBADF] 

arg is not a valid, open file descriptor. 

[EINVAL] 

fildes stream does not support multi¬ 
plexing. 

[EINVAL] 

arg is not a stream , or is already 
linked under a multiplexer. 

[EINVAL] 

The specified link operation would 
cause a "cycle” in the resulting 
configuration; that is, if a given 
stream head is linked into a multi¬ 
plexing configuration in more than 
one place. 


An IJLINK can also fail while waiting for the multi¬ 
plexing driver to acknowledge the link request, if a 
message indicating an error or a hangup is received at 
the stream head of jildes . In addition, an error code 
can be returned in the positive or negative ack¬ 
nowledgment message. For these cases, IJLINK will 
fail with errno set to the value in the message. 

Disconnects the two streams specified by fildes and 
ar g- fildes is the file descriptor of the stream con¬ 
nected to the multiplexing driver, fildes must 
correspond to the stream on which the ioctl I_LINK 
command was issued to link the stream below the 
multiplexing driver, arg is the multiplexer ID number 
that was returned by the IJLINK. If arg is -1, then all 
Streams which were linked to fildes are disconnected. 
As in I_LINK, this command requires the multiplexing 
driver to acknowledge the unlink. On failure, errno is 
set to one of the following values: 

[ENXIO] Hangup received on fildes. 

[ETIME] Time out before acknowledgment 

message was received at stream head. 

[ENOSR] Unable to allocate storage to perform 
the LUNLINK due to insufficient 
STREAMS memory resources. 
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[EINVAL] arg is an invalid multiplexer ID 
number or fildes is not the stream on 
which the I_LINK that returned arg 
was performed. 

An IJJNLINK can also fail while waiting for the mul¬ 
tiplexing driver to acknowledge the link request, if a 
message indicating an error or a hangup is received at 
the stream head of fildes. In addition, an error code 
can be returned in the positive or negative ack¬ 
nowledgment message. For these cases, IJJNLINK 
will fail with errno set to the value in the message. 


See Also 


close(S), fcntl(S), intro(S), ioctl(S), open(S), read(S), getmsg(S), 
poll(S), putmsg(S), signal(S), sigset(S), write(S) 

STREAMS Programmer’s Guide 
STREAMS Primer 

Diagnostics 


Unless specified otherwise above, the return value from ioctl is 0 upon 
success and -1 upon failure with errno set as indicated. 
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subsystem _ 

security subsystem component description 

Description 


The operating system includes extensions to UNIX that segregate com¬ 
mands and data which are used to implement system services. Many 
of these commands have been grouped into subsystems. A group of 
commands and data performing similar security relevant tasks or 
together protecting a set of resources is termed a protected subsystem. 

The operating system has the following protected subsystems: 

• Memory 

• Terminal 

• Line Printer 

• Backup 

• Authentication 

• Cron 

• Audit 

The description of each subsystem includes the following information: 

Group and Subsystem Authorization Name 

Each subsystem is associated with a subsys¬ 
tem authorization. The commands and files 
associated with the subsystem take the sub¬ 
system authorization name as their group 
name. Users wishing to use the subsystem 
must have the appropriate subsystem author¬ 
ization. 

Commands Each subsystem has a set of commands. 

Helper Programs Some subsystems use helper programs. 

These are programs which call other pro¬ 
grams. 

Data Files A subsystem’s programs use permanent and 

temporary data files. 

The administrative functions associated with each subsystem can be 
selected from the sysadmsh menu. Help information is available with 
each option. 
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The Memory Subsystem 


The mem subsystem authorization is defined to grant users the ability 
to use the memory subsystem commands to view total system activity. 
Users without this authorization may only view their own processes. 
Traditional UNIX allowed any user to view total system activity. This 
authorization was introduced to allow the administrator to isolate 
users, and restrict their ability to sense the activity of other users. 


Mem Authorization and Group Name 

In order to look at information in the mem subsystem, an administra¬ 
tor must have the mem authorization. The administrator responsible 
for maintaining users’ processes should be the only person with this 
authorization. This administrator may need to list users’ processes in 
order to select one or more of them for removal (using the kill (C) 
command). The following is a table of command modifications 
manmaged by the mem authorization: 


Command 

With Mem 

Without mem 

ps 

lists all processes 
(standard behavior) 

list processes owned 

by login user ID, or 
owned by real user ID 
of current process on 
current terminal 

whodo 

lists all processes 
(standard behavior) 

list processes on ter¬ 

minals owned by user 

ipcs 

lists all objects 

(standard behavior) 

list objects for which 

user is creator or 
owner or for which 
user has read access 


sysadmsh Selection 

The Memory subsystem does not have a sysadmsh selection as the 
Printer subsystem does. The Memory subsystem includes the system 
tables that contain information about memory and processes, which is 
accessed by several commonly-used UNIX utilities. 


Commands 

ps An administrator with mem authorization can use the 
ps (C) command to list all users’ processes. Using the 
command without the mem authorization shows only 
those processes associated with the user invoking it. 

whodo An administrator with mem authorization can use the 
whodo (ADM) command to list processes by terminal. 
Someone using the command without mem 
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authorization sees only the processes associated with 
his/her terminal. 

ipcs An administrator with mem authorization can use this 
command to view active semaphores, shared memory 
segments and message queues (known collectively as 
IPC entities). Without mem authorization, a user is 
restricted to viewing IPC entities that they own or 
created and those which have read permission. Even 
entities that are writable, but not readable, cannot be 
displayed. 

crash An administrator with mem authorization can run the 
crash program to report information on kernel data 
structures. The report includes security information. 

An administrator can search for information by running crash and 
specifying an identifier name. 


Helper Programs 

timex Because timex uses internal kernel data structures, it 
must be run from an account in the mem group. 


Accounting Programs 

Accounting programs such as sa (ADM), acctcom (ADM), and 
,rar(ADM) also use information in the mem subsystem. These pro¬ 
grams must be run from an account in the mem group. 


Data Files 

All files through which programs may access kernel memory are pro¬ 
tected with owner root, group mem, and mode -r-r-. As for all 

files, the root account bypasses the discretionary check on these files, 
and root programs may violate the System Architecture requirement. 
All root programs (those running with effective ID equal to root) must 
take care when running other programs, because those programs 
inherit the right to modify the running copy of the TCB. The following 
files are protected by die mem subsystem according to the above 
owner, group, and mode: 

The terminal subsystem protects the use of terminals by restricting 
the use of the write ( C) and mesg (C) commands. 


Terminal Authorization and Group Name 

In order to send information from one terminal to another, the user 
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sending information must have the terminal authorization and the 
receiving terminal must be configured to accept information from 
other terminals. 

All terminals belong to the terminal group. Each terminal is owned 
by and can only be used by a given user identity. 

sysadmsh Selection 

The terminal subsystem does not control sysadmsh functions. 


Commands 

When an unauthorized user uses the write command, any special con¬ 
trol codes or escape sequences he sends are trapped and converted to 
presentable ASCII characters. All control codes are output as 

~<char> 

where <char> is the character whose ASCII code is the character sent 
plus 0100. For instance, ASCII NUL (0), SOH (1), and ACK (6) are 
output as A @ (@ is 0100), A A (A is 0101) and A F, respectively, on the 
recipient’s terminal. The ASCII ESC (033) character writes as A [ and 
the DEL (0177) character writes as A ?. 

As an example of using the trusted write command, assume there is a 
hypothetical terminal that silently stores any string between two 
ASCH DC4 (024) characters. This string is transmitted from the same 
hypothetical terminal to the computer when the terminal receives a 
DC2 (022) character. Assume that a devious user knows the recipient 
of a write command has this terminal and tries to corrupt the 
recipient’s session by sending a damaging message. If this user did 
not have the terminal authorization, the recipient would see the mes¬ 
sage: 


How are y~Trm *~Tou today"E? 

The recipient would be alerted to an attempt on his session. In addi¬ 
tion, the terminal subsystem audits this event so you can locate 
suspect activity. On the other hand, if the sending user has the termi¬ 
nal authorization, the recipient would see the message: 

How are you today? 

The following commands are modified to support the terminal subsys¬ 
tem. 
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Command With Terminal Without Terminal 

write 

mesg 

unrestricted 

(standard behavior) 
changes sense of 
group write permis¬ 
sion only 

control codes output as ~<char> 

same 


A person with terminal authorization can use the write (C) command 
to write to another terminal and send control codes and escape 
sequences. A malicious user might use the command to send mali¬ 
cious commands and breach system security. 

Without the authorization, a user can use the write (C) command, but 
control codes and escape sequences are displayed on the receiving ter¬ 
minal in their ASCII form, thus warning the recipient of suspicious 
activity. Such activity is recorded by the audit facilities. 

The mesg y form of the command allows messages, but sets write per¬ 
mission for the terminal device group that has been set to terminal by 
the login program. The new write command is SGID to terminal, 
which allows it to send characters to user terminals that have used 
mesg y. of the file enough for the terminal group to write to the termi¬ 
nal. The new write command handles this change. Unlike the less 
trusted mesg, UNIX mesg never allows any permission to all users. 


Data Files 

The data files for the terminal subsystem are the terminals themselves. 
They belong to the terminal group at the start and end of each ses¬ 
sion, and all access is denied except to the user. The preferred way for 
a user to open and close access to a terminal is to use the mesg com¬ 
mand. When a session is not in progress on a terminal, only the super 
user can access the device file. Some terminal files are presented 
below. 

/dev/console This is the system console. Use of this terminal as 
a user terminal is discouraged because: 

• Messages from the kernel appear on 
/dev/console . To avoid losing these mes¬ 
sages or intermixing them with user mes¬ 
sages, it is better to use the console solely 
for the message output. 

• On some systems, physical access to the 
console is equivalent to having access to 
the entire system. Use another terminal 
unless the system configuration prevents 
this. In any event, allow physical access to 
/dev/console only to the most trusted users 
of the system. 
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/dev/tty* Most of the terminals on the system are named 
/dev/ttyl, /dev/tty2 , /dev/tty3 ,... These devices 
may at times be owned by a protected subsystem 
(such as uucp or terminal ) and be unavailable for 
general use. You have the option of configuring 
the terminals for login sessions, protected subsys¬ 
tems, or for nothing. 


Line Printer Subsystem 


The purpose of the Ip subsystem is to provide an administrative role 
that has control over printing facilities. Unlike the less trusted version 
of the lp commands, the trusted version does not require a special 
printer account that owns and executes (with the SUID bit set) all the 
printer programs. Instead, there is an lp group with multiple users as 
its members. 


Authorization/Group Name 


The lp authorization allows the user to be a printer administrator. 
This allows multiple Printer administrators. They force the adminis¬ 
trator to have a login userid (LUID) of 0 or a login name of Ip , a 
scheme that does not allow you much flexibility in account setups or 
individual accountability. 


All printer administrators are allowed to execute some commands that 
non-authorized users cannot, and can perform certain actions within 
commands that are restricted from other users. Only administrators 
may run accept, Ipadmin, Ipmove, Ipsched, Ipshut, reject and topq. 
For the other commands, enhancements due to lp authorization are 
detailed under each command heading. 


sysadmsh Selection 

The Ip authorization allows access to the printing functions under the 
System—>Printer selection as described in the “Using Printers” 
chapter. 


Commands 

To determine the invoker, the Printer subsystem command uses the 
immutable login user ID (LUID). Less trusted versions use various 
other schemes, all of which could be fooled. The commands listed 
here perform exactly like their traditional (less trusted) versions 
except where noted: 

accept The accept command may only be used by printer 
administrators. 
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cancel The less trusted version of cancel allowed any user to 
cancel any job. The originating user is notified of the 
cancellation via mail. The trusted version of cancel 
gives this right to printer administrators only. Mail is 
still sent to the originator when a job is canceled by the 
printer administrator. Other users can only remove jobs 
they submitted. 

disable The disable command operates without change from 
the less trusted version. 

enable The enable command operates without change from the 
less trusted version. 

Ip The trusted version of the Ip command, with the -w 
option enabled by you, never writes to the terminal 
directly as does the less trusted version of Ip. The 
trusted version of Ip knows that the system prohibits 
direct writing to another user’s terminal. Instead, the 
write (C) program is used to send the message; refer to 
the previous discussion of write in the terminal subsys¬ 
tem. 

The trusted version of the Ip command creates an out¬ 
put label for each file submitted. The output label con¬ 
tains the system label (the same as seen on most termi¬ 
nals), the owner, group, and mode of the file. To accu¬ 
rately determine the output label, the Ip command can¬ 
not accept input from pipes. This is because the discre¬ 
tionary attributes of a file are not available if the file 
was accessed on the other end of a pipe. Note that 
input redirection and temporary files may still be 
printed. 

Printer files are always copied to the printer spool by 
assuming the -c (copy) option, even if the user did not 
explicitly request it. By doing this, the lp subsystem 
ensures that the file cannot be altered between the time 
the request was made and the time it is printed. (The 
less trusted version of Ip does not guarantee that the file 
cannot be updated, even while the printer is running.) 
As added protection, the file being copied is locked 
during the formation of the output label and the copy 
operation, so that the file and label output accurately 
reflects the file being printed. 

Ipadmin The Ipadmin command may only be used by printer 
administrators. 

Ipforms The Ipforms command operates without change from 
the less trusted version. 
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Ipmove The Ipmove command may only be used by printer 
administrators. 

Ipsched The Ipsched command may only be used by printer 
administrators. When the Ipsched command uses a 
printer device dedicated to die lp subsystem, the sub¬ 
system guarantees exclusive use of the printer device 
each time it is used. Any prior activity (outside the lp 
subsystem) on that device is forcibly stopped. In this 
way, the lp subsystem ensures that the file being output 
is not interspersed with other output, unlike less trusted 
versions. 

Ipshut The Ipshut command may only be used by printer 
administrators. 

Ipstat The trusted version of Ipstat does not display other 
users’ jobs if the invoking user does not have the lp 
authorization. Knowing the jobs of other users is not 
necessary since unauthorized users cannot hold or can¬ 
cel those jobs anyway, printer administrators see all 
printer jobs, and they can hold or cancel any job that 
has been submitted. 

reject The reject command may be used only by printer 
administrators. 

topq The topq command may be used only by printer 
administrators. 


Data Files 

/usr/spool/lp All the files in this file hierarchy have the same 
formats and purposes as their counterparts in less 
trusted versions of UNIX. In the trusted version, 
the files are accessible by any printer administra¬ 
tor, so that the group permissions are the only ones 
of true importance. In all cases, the spool, its 
directories, and all data files allow no access to the 
user population. Hence, a user can be assured that 
a private file that is spooled for printing cannot be 
accessed or changed by untrusted users. 

Backup Subsystem 

The purpose of the backup subsystem is to provide a full set of disk 
and tape management tools without requiring detailed knowledge of 
UNIX. The backup administrator assumes responsibility of file system 
maintenance. The backup administrator is responsible for all actions 
which do not modify the format of file systems, while the root account 
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is still responsible for formatting, configuring, and maintaining the 
consistency of file system disk partitions. 


Authorization/Group Name 


The user with backup authorization, a Backup administrator, may per¬ 
form file backups. Restorations can only be made by the root user. 
The following authorizations are defined for the backup subsystem: 


Authorization Type Purpose 

backup 

queryspace 

primary 

secondary 

enables system backup command 

allows use of df program 


All disk partitions are protected with owner root, group backup and 
mode -r—r—.. The mount table (/etc/mnttab) is publicly readable, 
modified only by the mount command. The df program is SGID to 
backup, enforcing the queryspace and backup authorizations. 


sysadmsh Selection 

The backup authorization allows access to the backup functions under 
the Backups selection. 


Commands 

df The df command may only be used by Backup 

administrators. Otherwise, the options and output 
format remain the same as the less trusted version. 

mkfs The mkfs command may only be used by a 

member of the backup group (or by the super-user, 
which is discouraged). As always, this command 
must be used to initialize a filesystem after the 
partitions are laid out. Immediately after mkfs is 
run, you should run labelit to complete the initiali¬ 
zation. 

labelit The labelit program, documented in 

volcopy (ADM), associates the filesystem with a 
directory mount point. 


Helper Programs 

I etc! mount This program is used by backupif to display 

and modify the mounted file systems. 

letclfsck This program is used by backup to check and 

repair filesystems. 
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/usrlbin/backup This program is used to copy entire UNIX and 
XENIX filesystems to either magtape or car¬ 
tridge tape. 


/ usrl bin/xbackup This program is used to copy entire XENIX 
disk filesystems to either magtape or cartridge 
tape. 


lusrlbin/xrestore This program is used by replace entire XENIX 
filesystem images on magtape or cartridge tape 
to a clean (newly formatted with mkfs ) 

lusr/bin/restore This program is used by replace entire XENIX 
or UNIX filesystem images on magtape or car¬ 
tridge tape. 


lusrlbin/cpio This is the default backup program, cpio 
makes non-filesystem specific copies of 
filesystem data. 


Data Files 

/etc/default/filesy s 

This file contains the relationship between mounted 
filesystem devices and the directories on which they 
are mounted (mount points). It is used to display that 
relationship in both df and the backup selection. 
Because altering this file would display erroneous 
information to backup administrators and reading 
this file defaults the access protection created for the 
backup subsystem, this file must be accessible to the 
backup group only. 

/dev/[r]d[s]k* 

These block and character special files are the 
buffered interfaces to the disk partitions you have set 
up. They are used for mounting the filesystem they 
contain onto a directory. The backup group must be 
able to read and write these files. It is a severe secu¬ 
rity breach if others can access these files in any 
way. 

Authentication Subsystem 

The Authentication subsystem provides you with an exhaustive set of 
account management services. These services are: 

• self-checking to prevent dangerous actions, and 

• monitored extensively by the auditing system. 
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Authorization/Group Name 

The auth authorization allows an Authentication administrator to per¬ 
form sensitive actions on the Authentication database. This database 
contains all information on account ownership, types, authorizations, 
locked status, login times, password change times, and various other 
parameters. 

With the auth authorization, an Authentication administrator may 
alter Authentication parameters for other users. Because this database 
directly controls the attributes of any account on the system, this sub¬ 
system controls user access to your system. The trust you place in the 
system can be no greater than that placed in the Authentication 
administrators. Not only must they be trustworthy people, but they 
must also not leave any uncorrected mistakes when assigning authori¬ 
zations to the accounts they manage. 


sysadmsh Selection 

The auth authorization allows access to the user account management 
functions under Accounts. 


Commands 

passwd The passwd command in UNIX has been greatly 
enhanced for both security and flexibility. The trusted 
system checks on system-wide password parameters as 
well as user-specific ones and, depending on the results 
found, the user has a choice of choosing their own pass¬ 
word or having one chosen for them. You can set each 
account to do either one of these, or do both. A closely 
related change is that, regardless of the method for get¬ 
ting the password, you can have the system screen pass¬ 
words that are probable guesses by intruders. The pass¬ 
word selection method, as well as the optional restric¬ 
tion screening, are set by Authentication administrators 
in sysadmsh for a single account or for system-wide 
use. 

login The login command is no longer available as a com¬ 
mand used in a session to start a new session. Instead, 
a user must first log out before logging in as another 
user. 

Sublogins are forbidden since the LUID of a session may not change 
once it is set. This is to guarantee to you that the owner of a session is 
known at all times. If the login program were allowed to be run from 
a session, the login USERID would have to change and the guarantee 
would be broken. 
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The login program is still invoked from getty to start a user session. 
The procedure for logging in is almost the same. The user supplies a 
login name and the system requests a password. Once the password is 
entered, the system either lets the user log in or rejects the login 
attempt. A user may be rejected for a number of reasons: 

1. The account does not exist. 

2. The password was entered incorrectly. 

3. The password lifetime has been passed. 

4. The number of unsuccessful attempts made to the account has 
surpassed a system or account threshold. 

5. The number of unsuccessful attempts made to the terminal has 
surpassed a system or terminal threshold. 

6. An Authentication administrator has unconditionally locked 
the account. 

Reasons 3 throughh 6 notify the user that the Authentication adminis¬ 
trator has locked the account. 

If the user enters the correct login name/password combination, the 
last successful and unsuccessful login times are displayed on the ter¬ 
minal. The user should view the dates and times of each to determine 
if someone else has used the account. These dates may also be used to 
determine whether a Trojan horse program is simulating the login pro¬ 
cedure to obtain a password. A user with doubts about the authenticity 
of the login dates and times should report it to you. The earlier you 
take action on this, the better you can use fresh audit trails and 
people’s recollections to find the source of the problem. 

su The su program has been strengthened a great deal for 

security. It now uses information from the Authentication 
database in determining whether or not to allow a user to 
“switch” to another user. The following rules apply: 

• A user cannot use su to enter an account that has 
been locked. 

• The su command cannot be used as a means to 
bypass the lock-checking done by login , at , and 
cron. 

newgrp The newgrp command operates without change from the 
less trusted version. 

auths The auths command is especially tailored for UNIX to 
allow all users to adjust their authorizations. No user can 
increase authorizations, but one can temporarily decrease 
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authorizations in order to run an untrusted program or to 
prevent mistakes. More details on the authorizations and 
syntax are given in the man page for auths (C). 


Data Files 

/usr/adm/sulog 

This file keeps track of the history of use of the su program. 
Each line represents an attempt to run the su program. The 
date and time are first recorded on the line. Then, a 
means the attempt failed; a *+* means the attempt suc¬ 
ceeded. After the or *+’ code, the terminal of the 
attempt is provided. Last, the login name (using the login 
UID) of the invoker of su , together with the login name of 
the (attempted) changed real UID is presented. As an 
example, the following log excerpt presents some interest¬ 
ing situations: 


SU 02/29 19:19 
SU 03/01 20:22 
SU 03/04 04:13 
SU 03/07 20:30 
SU 03/07 20:30 
SU 03/07 21:38 
SU 03/07 21:39 
SU 03/07 21:39 
SU 03/07 21:40 
SU 03/07 21:40 
SU 03/07 21:41 
SU 03/07 21:41 
SU 03/07 21:47 


+ tty?? root-lp 
+ tty2 blf-root 
+ tty2 fred-projl 

- tty2 reese-star 
+ tty2 reese-star 
+ modem auth-root 
+ tty2 blf-root 

- tty7 daa-root 

- tty7 daa-root 

- tty7 daa-root 

- tty7 daa-root 

- tty7 daa-root 

+ tty2 fred-projl 


• Foremost, it appears as though the user daa is 
attempting to break into the root account, for there 
are many unsuccessful attempts (denoted with the 
y attribute) in rapid succession. That should be 
investigated further. 

• The su program does not require one to become the 
root user. In the log above, users root , fred and 
reese chose to assume the identities of other users. 

• In the effort by reese to become the star user, the 
first attempt failed and the next immediately suc¬ 
ceeded. This occurs frequently and is quite natural 
when users mistype the password of the other 
account. You should get suspicious, however, when 
the number of unsuccessful attempts becomes large. 
Such attempts, like the case with daa above, 
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probably means a breach of security. 


The su program was used by root to enter the Ip 
account. This occurrence was detached from any 
terminal, because of the special terminal designa¬ 
tion of tty??. This particular case occurred from 
letclrc where the Ipsched daemon is run. 


The lusrladmlsulog file needs attention periodically. It should be 
examined and then pruned, saving the most recent entries. The entries 
removed from the file should be archived if possible rather than com¬ 
pletely deleted. 

/tcb/files/auth 

This directory consists of subdirectories that contain 
private account data for all the accounts in the system. 
There is a file for each account. Because of the sensitive 
nature of the data here, all these files are completely 
protected from the users. 


/etc/auth/system 

This directory contains the system-wide authorization 
data for the machine. The I etc! authl system directory 
contains the Terminal Control database, the File Control 
database, the Command Control database and the Sys¬ 
tem Defaults database. This information is accessible to 
the users but not writable. The I etc! authl subsystems 
directory contains one file per protected subsystem, each 
containing the user permissions for that protected sub¬ 
system. This permissions file may only be read by the 
programs that are part of that protected subsystem, and 
is written by the auth user. 


cron Subsystem 

The purpose of the cron subsystem is to allow cron , at , and batch ser¬ 
vices that are audited as closely as normal login sessions. TTie cron 
subsystem provides a useful interface for controlling these facilities. 


Authorization/Group Name 

The authorization for the cron subsystem is given to cron administra¬ 
tors that are allowed to view or alter the authority for users to run the 
services associated with the cron subsystem. A user may run the pro¬ 
grams of the cron subsystem (excluding the use of the sysadmsh selec- j 
tions) without the authorization, so long as a cron administrator has 
granted the authority. 
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sysadmsh Selection 

The cron authorization allows access to the process management 
functions under Jobs. 


Commands 

at, batch, crontab 

These at commands operate without change from 
the less trusted version, except that the LUID 
(login UID), rather than the real UID, is used by at 
in determining the user. Because the LUID cannot 
be altered during a session, it promotes better 
accountability, at and batch jobs run with all of 
the login, real, and effective UIDs set to that of the 
login user. 


Helper Programs 

Itcbllibl cron This is the cron daemon that actually runs all at, 
batch, and crontab jobs. The at, batch, and cron¬ 
tab commands merely queue the jobs for the cron 
daemon to run. This daemon validates the account 
(ensures the account is not locked) before running 
the job. 


Data Files 


Although enumerated here, these data files are not manipulated 
directly by the cron administrator because of the arcane rules histori¬ 
cally applied to them by the cron subsystem programs. Instead, the 
sysadmsh provides a more coherent interface, reducing the possibility 
that users or permissions are set up incorrectly. 

/usr/lib/cron This is the directory containing all the 

cron administrative files. 

/usr/lib/cron/at.allow This file lists the users allowed to exe¬ 
cute the at or batch programs. If this 
file exists, it is used to determine the 
user’s authority. 


/usr/lib/cron/at.deny This file lists the users denied access 

to the at or batch programs. If 
/usr/lib/cron/at.allow does not exist, 
lusr/lib/cron/at.deny is used to deter¬ 
mine the user’s authority. You should 
be aware that an empty at.deny file 
permits access for all users. 
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/usr/Iib/cron/cron.allow This file lists the users allowed to exe¬ 
cute the crontab program. If this file 
exists, it is used to determine the 
user’s authority. 

/usr/lib/cron/cron.deny This file lists the users denied access 

to the crontab program. If 
lusrl lib/ cron/cron, allow does not 
exist, /usr/lib/cron/cron.deny is used 
to determine the user’s authority. You 
should be aware that an empty 
cron.deny file permits access for all 
users. 

/usr/lib/cron/.proto This file contains a list of commands 

that are executed before every at job. 
It contains commands primarily used 
to fix and restrict the environment of 
the user before running the job sub¬ 
mitted. 


/usr/lib/cron/.proto.b This file contains a list of commands 

that are executed before every batch 
job. It contains commands primarily 
used to fix and restrict the environ¬ 
ment of the user before running the 
job submitted. 


/usr/lib/cron/log This is a log of all at, batch, and cron¬ 

tab activity reported by the cron dae¬ 
mon since the system was rebooted. It 
provides an accurate ASCII log of all 
user initiated non-terminal activity. If 
the system is up for a very long time 
and there are many job submissions or 
crontab activity, this file should be 
periodically examined, pruned, and 
archived. 

/usr/lib/cron/OLDlog This is the log associated with the last 

time the system was up. Upon startup, 
the cron daemon moves any 
/usr/lib/cron/log file here. 


/usr/spool/cron This is the root of the subtree where 

all at, crontab, and batch jobs are 
stored, at and batch jobs are automat¬ 
ically cleared when they have finished 
executing. The -r option of crontab 
removes a crontab job. 


March 15,1989 


SUBSYSTEM-16 



SUBSYSTEM (M) 

Audit Subsystem 


SUBSYSTEM (M) 


The purpose of the audit subsystem is to provide an administrative 
role feat has control over auditing facilities. 


Authorization/Group Name 

The audit authorization allows the user to be the audit administrator. 
The audit adminsitrator can enable and disable auditing, examine 
audit records, generate reports and alter audit parameters. 


sysadmsh Selection 

The audit authorization allows access to the audit functions under the 
System—» Audit selection as described in the “Maintaining System 
Security” chapter. 


Commands 

auditcmd The command interface for audit subsystem activation, 
termination, statistic retrievel, and subsystem 
notification. 

auditd The auditd utility is the daemon that runs when audit¬ 
ing is enabled. 

reduce This program performs audit data analysis and rduc- 
tion. 


Data Files 


/tcb/files/audit/audit_parms 

Audit parameters file. 

/tcb/files/audit/* 

Audit log file directory. 

/tcb/audittmp Audit compaction file directory. 

See Also 


auditcmd(ADM), auditd(ADM), authck(ADM), integrity(ADM), 
reduce(ADM), chg_audit(ADM), auths(C), authcap(F), audit(HW) 
“Maintaining System Security” in the System Administrator’s Guide 


\ 
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subsystem is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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sxt _ 

pseudo-device driver 


Description 


sxt a pseudo-device driver that interposes a discipline between the 
standard tty line disciplines and a real device driver. The standard dis¬ 
ciplines manipulate virtual tty structures (channels) declared by the 
sxt driver, sxt acts as a discipline manipulating a real tty structure 
declared by a real device driver. The sxt driver is currently only used 
by the shl(C) command. 


Virtual ttys are named /dev/sxt??? and are allocated in groups of up 
to eight. To allocate a group, a program should exclusively open a file 

Ss fthe , fo ™ / dev/sxt??0 (channel 0) and then execute a 
oA1IUCLINK loctl call to initiate the multiplexing. 


Only one channel, the controlling channel, can receive input from the 
keyboard at a tune; others attempting to read will be blocked. 

There are two groups of ioctl( S) commands supported by sxt. The 
first group contains the standard ioctl commands described in 
termioQA), with the addition of the following: 


TIOCEXCL Set exclusive use mode: no further opens are permit¬ 
ted until the file has been closed. 

TIOCNXCL Reset exclusive use mode: further opens are once 
again permitted. 


The second group are directives to sxt itself. Some of these may onlv 
be executed on channel 0. 


SXTIOCLINK Allocate a channel group and multiplex the 
virtual ttys onto the real tty. The argument is 
the number of channels to allocate. This com¬ 
mand may only be executed on channel 0. 
Possible errors include: 

EINVAL The argument is out of range. 

ENOTTY The command was not issued from a 
real tty. 

ENXEO linesw is not configured with sxt. 

EBUSY An SXTIOCLINK command has 
already been issued for this real tty. 
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ENOMEM 

There is no system memory avail¬ 
able for allocating the virtual tty 
structures. 


EBADF Channel 0 was not opened before 
this call. 

SXTTOCSWTCH Set the controlling channel. Possible errors 
include: 

EINVAL An invalid channel number was 
given. 

EPERM The command was not executed 
from channel 0. 


SXTIOCWF 


SXTIOCUBLK 


SXTIOCSTAT 


Cause a channel to wait until it is the control¬ 
ling channel. This command will return the 
error, EINVAL, if an invalid channel number is 
given. 

Turn off the loblk control flag in the virtual tty 
of the indicated channel. The error EINVAL 
will be returned if an invalid number or chan¬ 
nel 0 is given. 

Get the status (blocked on input or output) of 
each channel and store in the sxtblock structure 
referenced by the argument. The error 
EFAULT will be returned if the structure can¬ 
not be written. 


SXTIOCTRACE Enable tracing. Tracing information is written 
to the console. This command has no effect if 
tracing is not configured. 

SXTIOCNOTRACE Disable tracing. This command has no effect if 
tracing is not configured. 


Files 


/dev/sxt??[0-7] virtual tty devices 

/usr/include/sys/sxt.h driver specific definitions 

See Also 

shl(C), stty(C), ioctl(S), open(S), termio(M) 
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systty _ 

system maintenance device 

Description 


H^i flle , /dC ^ yStty is the device on which system error messages are 
displayed. The actual physical device accessed via /dev/systty is 
selected during boot, and is typically the device used to control the 

de [ ault physical device /dev/systty is deter¬ 
mined by boot (HW) when the system is brought up. 

Initially /dev/console is linked to /dev/systty. 

Files 


/dev/systty 

See Also 


boot(HW), console(M) 


March 15,1989 


SYSTTY-1 










TERM (M) 


TERM (M) 


term _ 

conventional names for terminals 


Description 


These names are used by certain commands [e.g., maniC), tabs(C), 
tput(C), vi (C) and curses (S)] and are maintained as part of the shell 
environment in the environment variable TERM [see sh(C), 
profile (F), and environ (M)]. 

Entries in terminfo{ F) source files consist of a number of comma- 
separated fields. [To obtain the source description for a terminal, use 
the -I option of infocmp (ADM).] White space after each comma is 
ignored. The first line of each terminal description m the terminfo(,t) 
(feta base gives the names by which terminfol F) knows the terminal, 
separated by bar (I) characters. The first name given is the most com¬ 
mon abbreviation for the terminal [this is the one to use to set the 
environment variable TERMINFO in $HOMEI,profile ; see profile^)], 
the last name given should be a long name fully identifying the termi- 
nal and all others are understood as synonyms for the terminal name. 
All’names but the last should contain no blanks and must be unique m 
the first 14 characters; the last name may contain blanks for readabil¬ 
ity. 

Terminal names (except for the last, verbose entry) should be chosen 
using the following conventions. The particular piece of hardware 
making up the terminal should have a root name chosen. Forexample, 
for the AT&T 4425 terminal, the root name is att4425. feus name 
should not contain hyphens, except that synonyms may be chosen that 
do not conflict with other names. Up to 8 characters, chosen from 
ra-zO-91 make up a basic terminal name. Names should generally be 
based on original vendors, rather than local distributors. A terminal 
acquired from one vendor should not have more than one distinct 
basic name. Terminal sub-models, operational modes that the 
hardware can be in, or user preferences should be indicated^ 
appending a hyphen and an indicator of the mode T* 1118 ’ m , ,, & 1 
4425 ter minal in 132 column mode would be att4425-w. The follow¬ 
ing suffixes should be used where possible: 


Suffix Meaning 

-w Wide mode (more than 80 columns) 
-am With auto, margins (usually default) 

-nam Without automatic margins 

-n Number of lines on the screen 

-na No arrow keys (leave them in local) 


Example 

att4425-w 

vtlOO-am 

vtlOO-nam 

aaa-60 

clOO-na 
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-np Number of pages of memoiy 

-rv Reverse video 


cl00-4p 

att4415-rv 


To avoid conflicts with the naming conventions used in describing the 
tpmfifr mod f s of a termma l (e.g., -w), it is recommended that a 
tn™ iS nam< f not contam hyphens. Further, it is good practice 
, term “ al names used m the terminfo{ F) data base unique. 

th™-f n ^f S *1! ‘“'f P resent onl y for inclusion in other entries via 
the use facilities should have a ’+’ in their name, as in 4415+nI. 


Some of the known terminal names may include the 
complete list, type: Is -C /usr/Iib/terminfo/?): 


following (for a 


2621,hp2621 

2631 

2631-c 

2631-e 

2640,hp2640 

2645,hp2645 

3270 

33,tty33 

35,tty35 

37,tty37 

4000a 

4014,tek4014 

40,tty40 

43,tty43 

4410,5410 

4410-nfk,5410-nfk 

4410-nsl,5410-nsl 

4410-w,5410-w 

4410vl,5410vl 

441 Ov 1 - w,541 Ov 1 - w 

4415,5420 

4415-nl,5420-nl 

4415-rv,5420-rv 

4415-rv-nl,5420-rv-nl 

4415-w,5420-w 

4415-w-nl,5420-w-nl 


4415-w-rv,5420-w-rv 
4415-w-rv-nl,5420-w-rv-nl 


4418,5418 

4418-w,5418-w 

4420 

4424 

4424- 2 
4425,5425 

4425- fk,5425-fk 
4425-nl,5425-nl 

4425-w,5425-w 

4425-w-fk,5425-w-fk 


4425-nl-w,5425-nl-w 


4426 

450 


Hewlett-Packard 2621 series 

Hewlett-Packard 2631 line printer 

Hewlett-Packard 2631 line printer - compressed mode 

Hewlett-Packard 2631 line printer - expanded mode 

Hewlett-Packard 2640 series 

Hewlett-Packard 2645 series 

IBM Model 3270 

AT&T TELETYPE Model 33 KSR 

AT&T TELETYPE Model 35 KSR 

AT&T TELETYPE Model 37 KSR 

Trendata 4000a 

TEKTRONIX 4014 

AT&T TELETYPE Dataspeed 40/2 

AT&T TELETYPE Model 43 KSR 

AT&T 4410/5410 terminal in 80-column mode - version 2 

AT&T 4410/5410 without function keys - version 1 

AT&T 4410/5410 without pin defined 

AT&T 4410/5410 in 132-column mode 

4410/5410 terminal in 80-column mode - version 1 
vi^Z^ 410 ^ 410 * erm i na l in 132-column mode - version 1 
AT&T 4415/5420 in 80-column mode 
AT&T 4415/5420 without changing labels 
AT&T 4415/5420 80 columns in reverse video 

4415/5420 reverse vid eo without changing labels 
AT&T 4415/5420 in 132-column mode 
AT&T 4415/5420 in 132-column mode without changing 
labels 

AT&T 4415/5420 132 columns in reverse video 
AT&T 4415/5420 132 columns reverse video 
without changing labels 
AT&T 5418 in 80-column mode 
AT&T 5418 in 132-column mode 
AT&T TELETYPE Model 4420 
AT&T TELETYPE Model 4424 

AT&T4^5/M25 EM ° del 4424 in display function group ii 
AT&T 4425/5425 without function keys 
AT&T 4425/5425 without changing labels in 80-column 
mode 

AT&T 4425/5425 in 132-column mode 
AT&T 4425/5425 without function keys in 132-column 
mode 

AT&T 4425/5425 without changing labels in 132-column 
mode 

AT&T TELETYPE Model 4426S 
DASI450 (same as Diablo 1620) 
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450-12 

500,att500 

510,510a 

513bct,att513 

5320 

5420.2 

5420.2-w 

5620,dmd 

5620-24,dmd-24 

5620-34, dmd-34 

610,610bct 

610-w,610bct-w 

7300,pc7300,unix_pc 

735,ti 

745 

dumb 

hp 

lp 

pt505 

pt505-24 

sync 


DASI450 in 12-pitch mode 

AT&T-IS 500 terminal 

AT&T 510/510a in 80-column mode 

AT&T 513 bet terminal 

AT&T 5320 hardcopy terminal 

AT&T 5420 model 2 in 80-column mode 

AT&T 5420 model 2 in 132-column mode 


AT&T 5620 terminal 88 columns 

AT&T TELETYPE Model DMD 5620 in a 24x80 layer 

AT&T TELETYPE Model DMD 5620 in a 34x80 layer 

AT&T 610 bet terminal in 80-column mode 

AT&T 610 bet terminal in 132-column mode 

AT&T UNIX PC Model 7300 

Texas Instruments TI735 and TI725 


Texas Instruments TI745 
generic name for terminals that lack reverse 
line-feed and other special escape sequences 
Hewlett-Packard (same as 2645) 


generic name for a line printer 
AT&T Personal Terminal 505 (22 lines) 

AT&T Personal Terminal 505 (24-line mode) 
generic name for synchronous TELETYPE Model 
4540-compatible terminals 


Commands whose behavior depends on the type of terminal should 
accept arguments of the form -T term where term is one of die names 
given above; if no such argument is present, such commands should 
obtain the terminal type from the environment variable TERM , 
which, in turn, should contain term. 


Files 


/usr/lib/terminfo/? compiled terminal description data base 

See Also__ 

curses(S), profile(F), terminfo(M), tenninfo(Ip, environ(M), 
infocmp(ADM), sh(C), stty(C), tabs(C), tput(C), tplot(ADM), vi(C) 


Notes 

Not all programs follow the above naming conventions. 


March 15,1989 


TERM-3 







TERMINALS (M) 


TERMINALS (M) 


terminals _ 

list of supported terminals 


Description 


The following list, derived from the file /etc/termcap, shows the ter¬ 
minal name (suitable for use as a TERM shell variable), and a short 
description of the terminal. The advice in termcap{ F) will assist users 
m creating termcap entries for terminals not currently supported 


Name 


Terminal 


1200 
1620 
1640 
2392 
2392an 
2392ne 
2621 
2621k45 
262 lnl 
262 lnt 
262 lwl 
2622 
262x 
2640 
2640b 
300 
3045 
33 
37 
40 
4025 
4025-17 
4025-17ws 
4025ex 
43 
515 
5410 
5410-nfk 
5410132 
5420132 
5425 
5425-w 
610bct 


terminet 1200 
diablo 1620 
diablo 1640 
239x series 
hp 239x in ansi mode 
239x series 
hp 2621 

hp 2621 with 45 keyboard 

hp 2621 with no labels 

hp 2621 w/no tabs 

hp 2621 with labels 

hp 2622 

hp 262x series 

hp 2640a 

hp 264x series 

terminet 300 

datamedia 3045a 

model 33 teletype 

model 37 teletype 

teletype dataspeed 40/2 

tektronix 4024/4025/4027 

tek 4025 17 line window 

tek 4025 17 line window in workspace 

tek 4025 w/! 

model 43 teletype 

AT&T-IS 515 terminal in native mode 

5410 terminal 80 columns 

version 1 tty5410 entry without function keys 

5410 132 columns 

5420 132columns 

AT&T Teletype 5425 80 columns 

AT&T Teletype 5425 132 columns 

AT&T 610; 80 column; 98key keyboard 
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615mt 

620mtg 

7900 

8001 

912b 

925 

925so 

ATT5620 

Ma2 

TWO 

a980 

aa 

aaa 

aaa30 

aaa48db 

aaadb 

act5s 

adds 

adds25 

admll 

adml2 

adm2 

adm3 

adm31 

adm3a 

adm3a+ 

adm3al9.2 

adm3aso 

adm42 

adm5 

aj830 

altos3 

altos4 

altos5 

am219w 

amp219 

amp232 

ampex 

ansi 

ansi-nam 

arpanet 

at386 

at386-m 

atarist 

att513 

att513-w 


AT&T 615; 80 column; 98key keyboard 

AT&T 620; 80 column; 98key keyboard 

NCR 7900-1 

intecolor 

new televideo 

newer televideo 

newer televideo with attribute byte workaround 

5620 terminal 88 columns 

Ampex Model 232 / 132 lines 

Altos Computer Systems II 

adds consul 980 

ann arbor 

ann arbor ambassador/48 lines 

ann arbor ambassador 30/destructive backspace 

ann arbor ambassador 48/destructive backspace 

ann arbor ambassador 48/destructive backspace 

skinny act5 

adds viewpoint 

adds regent 25 with local printing 

lsi admll 

lsi adml2 

lsi adm2 

lsi adm3 

Lear Siegler ADM31 
lsi adm3a 
lsi adm3a+ 

lsi adm3a at 19.2 baud 
lsi adm3a with {} for standout 
lsi adm42 
lsi adm5 

anderson jacobson 
Altos ID 
Altos IV 
Altos V 

Ampex 132 Cols 
Ampex with Automargins 
Ampex Model 232 
ampex dialogue 80 
Ansi standard crt 

Ansi standard crt without automargin 

network 

at/386 console 

at/386 console 

Atari ST vt52 . . Qn 

AT&T-IS 513 Business Communications Terminal ou 

columns 

AT&T-IS 513 Business Communications Terminal 132 
columns 
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att605 

att630 

bct500 

bh3m 

big2621 

clOO 

cl004p 

clOOrv 

cl00rv4p 

cl00rv4pna 

cl00rv4ppp 

clOOrvs 

clOOs 

c3102 

carlock 

cci 

cdc456 

cdc456tst 

cdi 

cie467 

cit80 

cit80nam 

compucolor 

dl32 

datapoint 

delta 

dg 

digilog 

dm 1520 

dml521 

dm2500 

dm3025 

dm term 

dosansi 

dtlOO 

dtlOOw 

dt200 

dt80 

dt80132 

dtc300s 

du 

dumb 

dwl 

dw2 

ep40 

ep48 

esp925 

espHA 

AT&T 605 BCT 

AT&T 630 windowing terminal 

teletype 5541 

beehivelllm 

48 line 2621 
concept 100 
cl 00 w/4 pages 
cl00 rev video 
cl00 w/4 pages 
cl00 with no arrows 
cl00 with printer port 
slow reverse concept 100 
slow concept 100 
cromemco 3102 
klc 

cci 4574 
cdc 

cdc456tst 
cdi 1203 

C.Itoh 467,414 Graphics 
c.itoh 80 

C.Itoh 80 without automargins 

compucolorll 

datagraphix 132a 

datapoint 3360 

delta data 5000 

data general 6053 

digilog 333 

datamedia 1520 

datamedia 1521 

datamedia 2500 

datamedia 3025a 

Tandy deskmate terminal 

ANSI.SYS standard crt 

Tandy DT-100 terminal 

Tandy DT-100 terminal 

Tandy DT-200 
datamedia dt80/l 

datamedia dt80/l in 132 char mode 

dtc 300s 

dialup 

unknown 

decwriter I 

decwriter II 

execuport 4000 

execuport 4080 

esprit tvi925 emulation 

esprit 6310 in hazeltine emulation mode 
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ethemet 

exidy 

fos 

fox 

freelOO 

freellO 

ftl024 

gt40 

gt42 

hl500 

hl510 

hl520 

hl552 

hl552rv 

hl9 

hl9a 

hl9nk 

h2000 

hp 

hp2626 

hp2648 

hpansi 


hpansi-24 

hpex 

hpsub 

ilOO 

ibm3101 

ibm3151 

ibm3161 

ibm3163 

ibm3164 

ibm5151 

ibmcons 

ibmcons-43 

intext 


kn 

kt7ix 

lisa 

mlOO 

macterm 

macterm-nam 

mdlllO 

microb 

microterm 

microterm5 


network 

exidy sorcerer as dm2500 
Fortune system 
perkin elmer 1100 
liberty freedom 100 
Freedom 110 

Forward Technology graphics controller 


dec gt40 

dec gt42 

hazeltine 1500 

hazeltine 1510 

hazeltine 1520 

hazeltine 1552 

hazeltine 1552 reverse video 

heathkit hl9 w/ function keypad 

heathkit hl9 ansi mode 

heathkit w/numeric keypad (not function keys) 


hazeltine 2000 
hp 264x series 
hp 2626 

HP 2648a graphics terminal 

Hewlett Packard 700/44 in HP-PCterm mode, PC char- 


&ctcr set 

HP 700/44 in HP-PCterm 24 line mode, PC character set 

hp extended capabilites 

hp terminals — capability subset 

General Terminal 100A (formerly Infoton 100) 

IBM 3101-10 

3151 

3161 

3163 

3164 

ibm console 

Ansi standard with EGA 

Ansi EGA console in 43 line mode 

ISC modified owl 1200 

Intel IPC 

Kaypro 10 

kt70pcix 

kimtron kt-7 .. ., 

apple lisa xenix console display (white on black) 

radio shack model 100 

macintosh MacTerm in vt-100 mode 

MacTerm in vt-100 mode with automargin NOT set 

cybemex mdl-110 

micro bee series 

microterm act iv 

microterm act v 
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mime 

mime2a 

mime2as 

mime3a 

mime3ax 

mimefb 

mimehb 

mt70 

nabu 

netx 

nucterm 

oadm31 

omron 

ot80 

owl 

pe550 

pixel 

plasma 

ptl500 

pt210 

qume5 

qvtlOl 

qvtl01+ 

qvtlOl+so 

qvtlOlb 

qvtl02 

qvtl03 

qvtl08 

qvtl09 

qvtl 19 

qvtl 19+ 

qvt201 

qvt202 

qvt203 

regent 

regent 100 

regent20 

regent25 

regent25a 

regent40 

regent60 

regent60na 

ix303 

sbl 

sb2 

sexidy 

sk8620 

soroc 


microterm mimel 

microterm mime2a (emulating an enhanced vt52) 

microterm mime2a (emulating an enhanced soroc ia 120) 

mimel emulating 3a 

mimel emulating enhanced 3a 

full bright mimel 

half bright mimel 

morrow mt70 

nabu terminal 

netronics 

NUC homebrew 

old adm31 

Omron 8025AG 

onyx ot80 

perkin elmer 1200 

perkin elmer 550 

Pixel terminal 

plasma panel 

Convergent Technologies PT 

Tandy TRS-80 PT-210 printing terminal 

Qume Sprint 5 

Qume QVT-101 vers c 

Qume QVT-101 Plus vers c 

Qume QVT-101+ with protected mode/standout 

QVT-101 with cursor set to blinking underline 

Qume QVT 102 

Qume QVT-103 

QVT-108 

QVT-109 

Qume QVT-119 

Qume QVT-119 Plus vers c 

Qume QVT-201 

Qume QVT-202 

Qume QVT 203 PLUS 

adds regent series 

adds regent 100 

adds regent 20 

adds regent 25 

adds regent 25a 

adds regent 40 

adds Regent 60 

regent 60 w/no arrow keys 

rexon 303 terminal 

beehive super bee 

fixed superbee 

exidy smart 

Seiko 8620 

Soroc 120 
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sun 

sun-cmd 

sun-nic 


sunl 

superbeeic 

svtlOO 

svtl210 

svtl220 

svt52 

switch 

swtp 

tl061 

tl061f 

t3700 

t3800 

td200 

tek4013 

tek4014 

tek4014sm 

tek4015 

tek4015sm 

tek4023 

tek4107 

teletec 

terak 

ti 

ti745 

ti924 

ti924-8 

ti926 

ti931 

trslOO 

trsl6 

trs600 

tty4420 

tty4424 

tty4424-w 

tty5410 

tty5410-w 

tvi910 

tvi910+ 

tvi912 

tvi9220 

tvi9220w 

tvi924 


Sun Microsystems Workstation console 

Sun Microsystems Workstation console with scrollable 

history 

Sun Microsystems Workstation console without insert 
character 

old Sun Microsystems Workstation console 
super bee with insert char 
1220/PC, Sperry in VT100 mode 
Sperry 1210, standard setup 
Sperry 1220, standard setup 
1210/1220/PC, Sperry in VT52 mode 
intelligent switch 
southwest technical products ct82 
teleray 1061 

teleray 1061 with fast PROMs 

dumb teleray 3700 

teleray 3800 series 

Tandy 200 

tektronix 4012 

tektronix 4013 

tektronix 4014 

tektronix 4014 in small font 

tektronix 4015 

tektronix 4015 in small font 

tektronix 4023 

tektronix 4107 

Teletec Datascreen 

Terak emulating Datamedia 1520 

ti silent 700 

ti silent 745 

Texas Instruments 924 VDT 7 bit 
Texas Instruments 924 VDT 8 bit 
Texas Instruments 926 VDT 
Texas Instruments 931 VDT 
Tandy TRS-80 Model 100 
Tandy trs-80 model 16 console 
Tandy Model 600 
teletype 4420 
teletype 4424 

teletype 4424 in display function group u 
Teletype 5410 terminal in 80 column mode 
Teletype 5410 in 132 column mode 
old televideo 910 
televideo 910 PLUS 
old televideo 

Televideo 9220 w/status line @ bottom 
Televideo 9220 132 col w/status line @ bottom 
televideo924 
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tvi950 

tvi950-2p 

tvi950-4p 

tvi950-ap 

tvi950b 

tvi950ns 

v50 

v55 

vi200 

vi200f 

vi200ic 

vi200rv 

vi200rvic 

vi50 

vi55 

vis613 

vslOO 

vs100s 

vtlOO 

vtlOOn 

vtlOOnam 

vtlOOs 

vtlOOw 

vtl02 

vtl31 

vtl32 

vt220 

vt220d 

vt50 

vt50h 

vt52 

vt52so 

vtz 

W2110A 

ws584 

ws584fr 

ws584gr 

ws584nr 

ws584sp 

ws584sw 

ws584uk 

ws584us 

ws685 

wylOO 

wyl20 

wy 120-25 

wyl20-vb 


televideo950 

tvi 950 w/2 pages 

tvi 950 w/4 pages 

tvi 950 w/alt pages 

bare tvi950 no is 

tvi950 w/no standout 

Visual 50 emulation of DEC VT52 

Visual 55 emulation of DEC VT52 (called V55) 

visual 200 with function keys 

visual 200 no function keys 

visual 200 using insert char 

visual 200 reverse video 

visual 200 reverse video using insert char 

Visual 50 in ADDS viewpoint emulation 

Visual 55 using ADDS emulation 

Visual 613 

xterm terminal emulator 

xterm terminal emulator (small screen 24x80) 

dec vtlOO 

vtlOO w/no init 

DEC VT100 without automargins 

dec vtlOO 132 cols 14 lines 

dec vtlOO 132 cols 

dec vtl02 

dec vtl31 

vt-132 

dec vt220 generic 

DEC VT220 in vtlOO mode with DEC function key 
labeling 

dec vt50 
dec vt50h 
dec vt52 

dec vt52 with brackets added for standout use 
Zilog vtz 2/10 

Wang 2110 Asynch Data Entry Terminal - 80 column 
Olivetti WS584 

Olivetti WS584 with French keyboard 
Olivetti WS584 with German keyboard 
Olivetti WS584 with Norwegian/Danish keyboard 
Olivetti WS584 with Spanish keyboard 
Olivetti WS584 with Swedish/Finnish keyboard 
Olivetti WS584 with U.K. keyboard 
Olivetti WS584 with U.S.A. keyboard 
Olivetti WS685 
wyse 100 
Wyse 120 

Wyse 120 80-column 25-lines 
Wyse 120 Visible bell 
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wyl20-wvb 

wyl20w 

wyl20w-25 

wyl50 

wy 150-25 

wyl50-vb 

wyl50-wvb 

wyl50w 

wyl50w-25 

wy30 

wy30-vb 

wy350 

wy350-vb 

wy350-wvb 

wy350w 

wy50 

wy50-wvb 

wy501 

wy50n 

wy50vb 

wy50w 

wy60 

wy60-25 

wy60-42 

wy60-43 

wy60-vb 

wy60ak 

wy60w 

wy60w-25 

wy60w-42 

wy60w-43 

wy60w-vb 

wy75 

wy75-mc 

wy75-vb 

wy75-wvb 

wy75ap 

wy75w 

wy75x 

wy85 

wy85-vb 

wy85-wvb 


wysel20-wvb 
Wyse 120 132-column 
Wyse 120 132-column 25-lines 
Wyse 150 

Wyse 150 80-column 25-lines 

Wyse 150 Visible bell 

wysel50-wvb 

Wyse 150 132-column 

Wyse 150 132-column 25-lines 

Wyse WY-30 in wy30 mode 

wyse 30 Visible bell 

Wyse 350 80 column color terminal emulating wy50 

wyse 350 Visible bell 

wyse 350 132-column Visible bell 

Wyse 350 132 column color terminal emulating wy50 

Wyse 50/80 Wyse WY-50 with 80 column screen 

wyse 50 132-column Visible bell 

Wyse WY-60 with 80 column/43 line screen in WY504- 

mode 

Wyse WY-50 - 80 column screen, no automargin 
Wyse WY-50/80vb Wyse WY-50/80 with visible bell 
Wyse WY-50/132 Wyse WY-50 with 132 column 
screen 

Wyse WY-60 with 80 column/24 line screen in wy60 
mode 

wyse 60 80-column 25-lines 
wyse 60 80-column 42-lines 
wyse 60 80-column 43-lines 
Wyse 60 Visible bell 

Wyse 60 in wy60 mode with ANSI arrow keys + 

Wyse WY-60 with 132 column/24 line screen in wy60 
mode 

wyse 60 132-column 25-lines 

wyse 60 132-column 42-lines 

wyse 60 132-column 43-lines 

Wyse 60 132-column Visible bell 

Wyse WY-75 with 80 column line 

wyse 75 with magic cookies 

wyse 75 with visible bell 

wyse 75 with visible bell 132 columns 

Wyse WY-75 with Applications and Cursor keypad 

modes 

Wyse WY-75 in 132 column mode 

Wyse WY-75 with 132 column lines in vi editor mode 

Wyse 85 in 80 column mode, vtlOO emulation 

wyse 85 with visible bell 

wyse 85 with visible bell 132-columns 
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wy85w 

wy85w 

wy99gt 

wy99gt-25 

wy99gt-25-w 

wy99gt-vb 

wy99gt-w 

wy99gt-w-vb 

wysel20ak 

xl720 

xitex 

z29 

z39 

zen30 

zen40 

zen50 

zephyr 


wyse 99gt 80-column 25-lines 
wyse 99gt 132-column 25-lines 
Wyse 99gt Visible bell 
wyse 99gt 132-column 
wyse99gt-wvb 

Wyse 120 with ANSI key values 

xerox 1720 

xitex set-100 

zenith z29 

Zenith Z-39 

zentec 30 

zentec 40 

zentec 50 

zentec zephyr220 in vtlOO mode 



zephymam zentec zephyr220 in vtlOO mode w/out automargins 

Files 

/etc/termcap 

See Also 

tset(C), environ(M), termcap(F) 
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terminfo _ 

terminal capability data base 


Syntax 

/usr/lib/terminfo/? /* 


Description 

terminfo is a compiled database [see ttc(C)] describing the capabilities 
of terminals. Terminals are described in terminfo source descriptions 
by giving a set of capabilities which they have, by describing how 
operations are performed, by describing padding requirements, and by 
specifying initialization sequences. This database is used, for exam- 
pie, by vi(C) and curses(S), so they can work with a variety of termi¬ 
nal’s without changes to the programs. To obtain the source descnp- 
tion for a terminal, use the -I option of infocmp (ADM). When doing 
an infocmp for the terminal you are on, there is no difference between 
infocmp and infocmp -I. 

Entries in terminfo source files consist of a number of fields separated 
by commas. White space after each comma is ignored. The first line 
of each terminal description in the terminfo database gives the name 
by which terminfo knows the terminal, separated by bar ( I ) charac¬ 
ters The first name given is the most common abbreviation for the 
terminal [this is the one to use to set the environment variable TERM 
in $HOMEI.profile-, see profile^ F)]; the last name given should be a 
long name fully identifying the terminal, and all others are understood 
as synonyms for the terminal name. All names but the last should 
contain no blanks and must be unique in the first 14 characters; the 
last name may contain blanks for readability. 

Terminal names (except for the last verbose entry) should be chosen 
using the following conventions. The particular piece of hardware 
making up the terminal should have a root name chosen, for example, 
for the AT&T 4425 terminal, att4425. Modes that the hardware can 
be in or user preferences, should be indicated by appending a hyphen 
and an indicator of the mode. See term( M) for examples and more 
information on choosing names and synonyms. 


PART 1: TERMINAL CAPABILITIES 

Capabilities in terminfo are of three types: boolean capabilities 
(which show that the terminal has some particular feature), numeric 
capabilities (which specify the size of the terminal or particular 
features), and string capabilities (which provide a sequence that can 
be used to perform particular terminal operations). 
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In the following tables, a Variable is the name by which a C program¬ 
mer accesses a capability (at the terminfo level). A Capname is the 
short name for a capability used in the source description. It is used 
by a person updating the database and by the tput(C) command when 
asking what the value of the capability is for a particular terminal. A 
Termcap Code is a two-letter code that corresponds to the old 
termcap capability name. 


Capability names have no hard length limit, but an informal limit of 
five characters has been adopted to keep them short. Whenever possi¬ 
ble, names are chosen to be the same as or similar to those specified 
by the ANSI X3.64-1979 standard. Semantics are also intended to 
match those of the ANSI standard. 

All string capabilities listed below may have padding specified, with 
the exception of those used for input. Input capabilities, listed under 
the Strings section in the following table, have names beginning with 
key_. The following indicators may appear at the end of the Descrip¬ 
tion for a variable. 

(G) 

indicates that the string is passed through tparm() with parameters 
(parms) as given (#p 


(*) 

indicates 

affected 

(#•> 

indicates 


that padding may 
the f th parameter 


be based on the number of lines 
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Booleans 


Variable 

Cap- 

name 

Termcap 

Code 

auto_left_margin 

bw 

bw 

auto_right_margin 

am 

am 

back_color_erase 

bee 

be 

can_change 

ccc 

cc 

ceol_standout_glitch 

xhp 

xs 

col_addr_glitch 

xhpa 

YA 

cpi_changes_res 

cpix 

YF 

cr_cancels_micro_mode 

crxm 

YB 

eat_newline_glitch 

xenl 

xn 

erase_overs trike 

eo 

eo 

generic_type 

gn 

gn 

hard_copy 

he 

he 

hard_cursor 

chts 

HC 

has_meta_key 

km 

km 

has_print_wheel 

daisy 

YC 

has_status_line 

hs 

hs 

hue_lightness_saturation 

his 

hi 

insert_null_glitch 

in 

in 

lpi_changes_res 

lpix 

YG 

memory_above 

da 

da 

memory _below 

db 

db 

move_insert_mode 

mir 

mi 

move_standout_mode 

msgr 

ms 

needs_xon_xoff 

nxon 

nx 

no_esc_ctlc 

xsb 

xb 

no_pad_char 

npc 

NP 

non_dest_scroll_region 

ndscr 

ND 

non_rev_rmcup 

rurmc 

NR 

over_strike 

os 

os 

prtr_silent 

mc5i 


row_addr_glitch 

xvpa 

YD 

semi_auto_right_margin 

sam 

YE 

status_line_esc_ok 

eslok 

es 

dest_tabs_magic_smso 

xt 

xt 

tilde _glitch 

hz 

hz 

transparent_underline 

ul 

ul 

xon_xoff 

xon 

xo 


Description 

cubl wraps from column 0 to last column 
Terminal has automatic margins 
Screen erased with background color 
Terminal can re-defme existing color 
Standout not erased by overwriting (hp) 

Only positive motion for hpa/mhpa caps 
Changing character pitch changes resolution 
Using cr turns off micro mode 
Newline ignored after 80 columns ( Concept ) 

Can erase overstrikes with a blank 
Generic line type (e.g., dialup, switch) 

Hardcopy terminal 

Cursor is hard to see 

Has a meta key (shift, sets parity bit) 

Printer needs operator to change character set 
Has extra "status line" 

Terminal uses only HLS color notation (Tektronix) 
Insert mode distinguishes nulls 
Changing line pitch changes resolution 
Display may be retained above the screen 
Display may be retained below the screen 
Safe to move while in insert mode 
Safe to move in standout modes 
Padding won’t work, xon/xoff required 
Beehive (fl=escape, f2=ctrl C) 

Pad character doesn’t exist 
Scrolling region is non-destructive 
smcup does not reverse rmcup 
Terminal overstrikes on hard-copy terminal 

Only positive motion for vpa/mvpa caps 
Printing in last column causes cr 
Escape can be used on the status line 
Destructive tabs, magic smso char (tl061) 
Hazeltine; can’t print tilde O 
Underline character overstrikes 
Terminal uses xon/xoff handshaking 
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Numbers 

Variable 

Cap- 

name 

Termcap 

Code 

Description 

buffer_capacity 

bufsz 

Ya 

Number of bytes buffered before printing 

columns 

cols 

CO 

Number of columns in a line 

dot_vert_spacing 

spinv 

Yb 

Spacing of pins vertically in pins per inch 

dot_horz_spacing 

spinh 

Yc 

Spacing of dots horizontally in dots per inch 

init_labs 

it 

it 

Tabs initially every # spaces 

label_height 

lh 

lh 

Number of rows in each label 

label_width 

lw 

lw 

Number of columns in each label 

lines 

lines 

li 

Number of lines on a screen or a page 

lines_of_memory 

lm 

lm 

Lines of memory if > lines; 0 means varies 

magic_cookie_glitch 

xmc 

sg 

Number of blank characters left by smso or rmso 

max_attributes 

ma 

ma 

Maximum combined video attributes terminal can display 

max_colors 

colors 

Co 

Maximum number of colors on the screen 

max_micro_address 

maddr 

Yd 

Maximum value in micro_..._address 

max_micro_jump 

mjump 

Ye 

Maximum value in parm_..._micro 

max_pairs 

pairs 

pa 

Maximum number of color-pairs on the screen 

maximum_windows 

wnum 

MW 

Maximum number of definable windows 

micro_col_size 

mcs 

Yf 

Character step size when in micro mode 

micro_line_size 

mis 

Yg 

Line step size when in micro mode 

no_color_video 

ncv 

NC 

Video attributes that can’t be used with colors 

number_of_pins 

npins 

Yh 

Number of pins in print-head 

numjabels 

nlab 

N1 

Number of labels on screen (start at 1) 

output_res_char 

ore 

Yi 

Horizontal resolution in units per character 

output_res_line 

orl 

Yj 

Vertical resolution in units per line 

output_res_horz_inch 

orhi 

Yk 

Horizontal resolution in units per inch 

output_res_vert_inch 

orvi 

Yl 

Vertical resolution in units per inch 

padding_baud_rate 

pb 

pb 

Lowest baud rate where padding needed 

print_rate 

cps 

Ym 

Print rate in characters per second 

virtual_terminal 

vt 

vt 

Virtual terminal number (UNIX system) 

wide_char_size 

widcs 

Yn 

Character step size when in double wide mode 

width_status_line 

wsl 

ws 

Number of columns in status line 
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Strings 


Variable 

Cap- 

name 

Termcap 

Code 

acs_chars 

acsc 

ac 

back_tab 

cbt 

bt 

bell 

bel 

bl 

carriage_retum 

cr 

cr 

change_char_pitch 

cpi 

ZA 

change_line_pitch 

Ipi 

ZB 

change_res_horz 

chr 

ZC 

change_res_vert 

cvr 

ZD 

change_scroll_region 

csr 

cs 

char_padding 

rmp 

rP 

char_set_names 

csnm 

Zy 

clear_all_tabs 

tbc 

ct 

clear_margins 

mgc 

MC 

clear_screen 

clear 

cl 

clr_bol 

ell 

cb 

clr_eol 

el 

ce 

clr_eos 

ed 

cd 

column_address 

hpa 

ch 

command_character 

cmdch 

CC 

create_window 

cwin 

cw 

cursor_address 

cup 

cm 

cursor_down 

cudl 

do 

cursor_home 

home 

ho 

cursor_invisible 

civis 

vi 

cursorjeft 

cubl 

le 

cursor_mem_address 

mrcup 

CM 

cursor_normal 

cnorm 

ve 

cursor_right 

cufl 

nd 

cursor_to_ll 

11 

11 

cursor_up 

cuul 

up 

cursor_visible 

cvvis 

vs 

define_char 

defc 

ZE 

delete_character 

dchl 

dc 

delete_line 

dll 

dl 

delete_phone 

dial 

DI 

dis_status_line 

dsl 

ds 

display_clock 

dclk 

DK 

down_half_line 

hd 

hd 

ena_acs 

enacs 

eA 

enter_alt_charset_mode 

smacs 

as 

enter_am_mode 

smam 

SA 

enter_bl ink_mode 

blink 

mb 

enter_bold_mode 

bold 

md 

enter_ca_mode 

smcup 

ti 

enter_delete_mode 

smdc 

dm 


Description 

Graphic charset pairs aAbBcC - def=vtl00 
Back tab 

Audible signal (bell) 

Carriage return (*) 

Change number of characters per inch (dg 
Change number of lines per inch (dg 
Change horizontal resolution (dg 
Change vertical resolution (dg 
Change to lines #1 through #2 (vtlOO) (G) 

Like ip but when in replace mode 
List of character set names 
Clear all tab stops 

Clear all margins (top, bottom, and sides) 

Clear screen and home cursor (*) 

Clear to beginning of line, inclusive 
Clear to end of line 
Clear to end of display (*) 

Horizontal position absolute (G) 

Terminal settable cmd character in prototype 
Define win #1 to go from #2,#3 to #4,#5 
Move to row #1 col #2 (G) 

Down one line 
Home cursor (if no cup) 

Make cursor invisible 
Move left one space. 

Memory relative cursor addressing (G) 

Make cursor appear normal (undo vs/vi) 
Non-destructive space (cursor or carriage right) 
Last line, first column (if no cup) 

Upline (cursor up) 

Make cursor very visible 

Define a character in a character set f 

Delete character (*) 

Delete line (*) 

Dial phone number #1 
Disable status line 
Display time-of-day clock 
Half-line down (forward 1/2 linefeed) 

Enable alternate character set 

Start alternate character set 

Turn on automatic margins 

Turn on blinking 

Turn on bold (extra bright) mode 

String to begin programs that use cup 

Delete mode (enter) 
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TERMINFO (M) 


TERMINFO (M) 

Strings (cont.) 

Variable 

Cap- 

name 

Termcap 

Code 

TERMINFO (M) 

Description 

enter dim mode 

dim 

mh 

Turn on half-bright mode 

enter_doublewide_mode 

swidm 

ZF 

Enable double wide printing 

enter_draft_quality 

sdrfq 

ZG 

Set draft quality print 

enter_insert_mode 

smir 

im 

Insert mode (enter) 

enter_ital ics_mode 

sitm 

ZH 

Enable italics 

enter_leftward_mode 

slm 

ZL 

Enable leftward carriage motion 

enter_micro_mode 

smicm 

ZJ 

Enable micro motion capabilities 

enter_near_letter_quality 

snlq 

ZK 

Set near-letter quality print 

enter_normal_quality 

snrmq 

ZL 

Set normal quality print 

enter_protected_mode 

prot 

mp 

Turn on protected mode 

enter_reverse_mode 

rev 

mr 

Turn on reverse video mode 

enter_secure_mode 

invis 

mk 

Turn on blank mode (characters invisible) 

enter_sh ado w_mode 

sshm 

ZM 

Enable shadow printing 

enter_standout_mode 

smso 

so 

Begin standout mode 

enter_subscript_mode 

ssubm 

ZN 

Enable subscript printing 

enter_superscript_mode 

ssupm 

ZO 

Enable superscript printing 

enter_underl ine_mode 

smul 

us 

Start underscore mode 

enter_upward_mode 

sum 

ZP 

Enable upward carriage motion 

enter_xon_mode 

smxon 

sx 

Turn on xon/xoff handshaking 

erase_chars 

ech 

ec 

Erase #1 characters (G) 

exit_alt_charset_mode 

rmacs 

ae 

End alternate character set 

exit_am_mode 

imam 

RA 

Turn off automatic margins 

exit_attribute_mode 

sgrO 

me 

Turn off all attributes 

exit_ca_mode 

rmcup 

te 

String to end programs that use cup 

exit_delete_mode 

rmdc 

ed 

End delete mode 

exit_doublewide_mode 

rwidm 

ZQ 

Disable double wide printing 

exit_insert_mode 

rmir 

ei 

End insert mode 

exit_ital ics_mode 

ritm 

ZR 

Disable italics 

exit_leftward_mode 

rim 

ZS 

Enable rightward (normal) carriage motion 

exit_micro_mode 

rmicm 

ZT 

Disable micro motion capabilities 

exit_shadow_mode 

rshm 

ZU 

Disable shadow printing 

exit_standout_mode 

rmso 

se 

End standout mode 

exit_subscript_mode 

rsubm 

ZV 

Disable subscript printing 

exit_superscript_mode 

rsupm 

zw 

Disable superscript printing 

exit_underline_mode 

rmul 

ue 

End underscore mode 

exit_upward_mode 

rum 

zx 

Enable downward (normal) carriage motion 

exit_xon_mode 

rmxon 

RX 

Turn off xon/xoff handshaking 

fixed_pause 

pause 

PA 

Pause for 2-3 seconds 

flash_hook 

hook 

fh 

Flash the switch hook 

flash_screen 

flash 

vb 

Visible bell (may not move cursor) 

form_feed 

ff 

ff 

Hardcopy terminal page eject (*) 

from_status_line 

fsl 

fs 

Return from status line 

goto_window 

wingo 

WG 

Got to window #1 

hangup 

hup 

HU 

Hang-up phone 
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TERMINFO (M) 


TERMINFO (M) 


Strings (corn.) 


Variable 

Cap- 

name 

Termcap 

Code 

ini t_l string 

isl 

il 

init_2string 

is2 

is 

ini t_3 string 

is3 

i3 

init_file 

if 

if 

init_prog 

iprog 

iP 

initialize_color 

initc 

Ic 

initialize_pair 

initp 

IP 

insert_character 

ichl 

ic 

insert_line 

ill 

al 

ins ert_p adding 

ip 

»P 

key_al 

kal 

K1 

key_a3 

ka3 

K3 

key_b2 

kb2 

K2 

key_backspace 

kbs 

kb 

key_beg 

kbeg 

@1 

key_btab 

kcbt 

kB 

key_cl 

kcl 

K4 

key_c3 

kc3 

K5 

key_cancel 

kcan 

@2 

key_catab 

ktbc 

ka 

key_clear 

kclr 

kC 

key_close 

kclo 

@3 

key_command 

kcmd 

@4 

key_copy 

kcpy 

@5 

key_create 

kcrt 

@6 

key_ctab 

kctab 

kt 

key_dc 

kdchl 

kD 

key_dl 

kdll 

kL 

key_down 

kcudl 

kd 

key_eic 

krmir 

kM 

key_end 

kend 

@7 

key_enter 

kent 

@8 

key_eol 

kel 

kE 

key_eos 

ked 

kS 

key_exit 

kext 

@9 

key_f0 

kfO 

kO 

key_fl 

kfl 

kl 

key_f2 

kf2 

k2 

key_f3 

kf3 

k3 

key_f4 

kf4 

k4 

key_f5 

kf5 

k5 

key_f6 

kf6 

k6 

key_f7 

kf7 

k7 

key_f8 

kf8 

k8 


Description 


Terminal or printer initialization string 

Terminal or printer initialization string 

Terminal or printer initialization string 

Name of initialization file 

Path name of program for initialization 

Initialize the definition of color 

Initialize color-pair 

Insert character 

Add new blank line (*) 

Insert pad after character inserted (*) 

KEY_A1,0534, upper left of keypad 
KEY_A3,0535, upper right of keypad 
KEY_B2,0536, center of keypad 
KEY_B ACKSPACE, 0407, sent by backspace key 
KEY_BEG, 0542, sent by beg(inning) key 
KEY_BTAB, 0541, sent by back-tab key 
KEY_C1,0537, lower left of keypad 
KEY_C3,0540, lower right of keypad 
KEY.CANCEL, 0543, sent by cancel key 
KEY.CATAB, 0526, sent by clear-all-tabs key 
KEY_CLEAR, 0515, sent by clear-screen or erase key 
KEY.CLOSE, 0544, sent by close key 
KEY_COMMAND, 0545, sent by cmd (command) key 
KEY_COPY, 0546, sent by copy key 
KEY.CREATE, 0547, sent by create key 
KEY_CTAB, 0525, sent by clear-tab key 
KEY_DC, 0512, sent by delete-character key 
KEY_DL, 0510, sent by delete-line key 
KEY_DOWN, 0402, sent by terminal down-arrow key 
KEY_EIC, 0514, sent by rmir or smir in insert mode 
KEY.END, 0550, sent by end key 
KEY.ENTER, 0527, sent by enter/send key 
KEY_EOL, 0517, sent by clear-to-end-of-line key 
KEY_EOS, 0516, sent by clear-to-end-of-screen key 
KEY.EXTT, 0551, sent by exit key 
KEY_F(0), 0410, sou by function key fO 
KEY_F(C), 0411, sent by function key fl 
KEY_F(S), 0412, sent by function key f2 
KEY_F(S), 0413, sent by function key f3 
KEY_F(F), 0414, sent by function key f4 
KEY_F(M), 0415, sent by function key f5 
KEY_F(6), 0416, sent by function key f6 
KEY_F(7), 0417, sent by function key f7 
KEY_F(8), 0420, sent by function key f8 
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TERMINFO (M) 

Strings (cont.) 

Variable 

name 

Termcap 

Code 

TERMINFO (M) 

Description 

key_f9 

kf9 

k9 

KEY_F(9), 0421, sent by function key f9 

key_flO 

kflO 

k; 

KEY_F(ADM), 0422, sent by function key flO 

key_fl 1 

kfll 

FI 

KEY_F(ADM), 0423, sent by function key fl 1 

key_fl2 

kfl2 

F2 

KEY_F(ADM), 0424, sent by function key fl2 

key_fl3 

kfl3 

F3 

KEY_F(ADM), 0425, sent by function key fl3 

key_fl4 

kfl4 

F4 

KEY_F(ADM), 0426, sent by function key fl4 

key_fl5 

kfl5 

F5 

KEY_F(ADM), 0427, sent by function key fl5 

key_fl6 

kfl6 

F6 

KEY_F(ADM), 0430, salt by function key fl6 

key_fl7 

kfl7 

F7 

KEY_F(ADM), 0431, sent by function key fl7 

key_fl8 

kfl 8 

F8 

KEY_F(ADM), 0432, sent by function key fl8 

key_fl9 

kfl9 

F9 

KEY_F(ADM), 0433, sent by function key fl9 

kcy_f20 

kf20 

FA 

KEY_F(20), 0434, sent by function key f20 

key_f21 

kf21 

FB 

KEY_F(21), 0435, sent by function key f21 

key_f22 

kf22 

FC 

KEY_F(22), 0436, sent by function key f22 

kcy_f23 

kf23 

FD 

KEY_F(23), 0437, sent by function key f23 

key_f24 

kf24 

FE 

KEY_F(24), 0440, sent by function key f24 

key_f25 

kf25 

FF 

KEY_F(25), 0441, sent by function key f25 

key_f26 

kf26 

FG 

KEY_F(26), 0442, sent by function key f26 

key_f27 

kf27 

FH 

KEY_F(27), 0443, sent by function key f27 

key_f28 

kf28 

FI 

KEY_F(28), 0444, sent by function key f28 

key_f29 

kf29 

FJ 

KEY_F(29), 0445, sent by function key f29 

key_f30 

kf30 

FK 

KEY_F(S), 0446, sent by function key £30 

key_f31 

kf31 

FL 

KEY_F(S), 0447, sent by function key f31 

key_f32 

kf32 

FM 

KEY_F(S), 0450, sent by function key f32 

key_f33 

k03 

FN 

KEY_F(ADM), 0451, sent by function key fl3 

key_f34 

kf34 

FO 

KEY_F(S), 0452, sent by function key £34 

key_f35 

kf35 

FP 

KEY_F(S), 0453, sent by function key £35 

key_f36 

kf36 

FQ 

KEY_F(S), 0454, sent by function key £36 

key_f37 

kB7 

FR 

KEY_F(S), 0455, sent by function key £37 

key_f38 

kf38 

FS 

KEY_F(S), 0456, sent by function key £38 

key_09 

kf39 

FT 

KEY_F(S), 0457, sent by function key £39 

key_f40 

kf40 

FU 

KEY_F(40), 0460, sent by function key £40 

key_f41 

kf41 

FV 

KEY_F(41), 0461, sent by function key f41 

key_f42 

kf42 

FW 

KEY_F(42), 0462, sent by function key £42 

key_f43 

kf43 

FX 

KEY_F(43), 0463, sent by function key £43 

key_f44 

kf44 

FY 

KEY_F(44), 0464, sent by function key £44 

key_f45 

kf45 

FZ 

KEY_F(45), 0465, sent by function key £45 

key_f46 

kf46 

Fa 

KEY_F(46), 0466, sent by function key £46 

key_f47 

kf47 

Fb 

KEY_F(47), 0467, sent by function key £47 

key_f48 

kf48 

Fc 

KEY_F(48), 0470, sent by function key £48 

key_f49 

kf49 

Fd 

KEY_F(49), 0471, sent by function key £49 

key_f50 

kf50 

Fe 

KEY_F(50), 0472, sent by function key £50 

key_f51 

kf51 

Ff 

KEY_F(51), 0473, sent by function key £51 
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TERMINFO (M) 


TERMINFO (M) 


Strings (corn.) 


Variable 

Cap- 

name 

Termcap 

Code 

Description 

key_f52 

kf52 

Fg 

KEY_F(52), 0474, sent by function key f52 

key_f53 

kf53 

Fh 

KEY_F(53), 0475, sent by function key f53 

key_f54 

kf54 

Fi 

KEY_F(54), 0476, sent by function key f54 

key_f55 

kf55 

Fj 

KEY_F(55), 0477, sent by function key f55 

key_f56 

kf56 

Fk 

KEY_F(56), 0500, sent by function key f56 

key_f57 

kf57 

FI 

KEY_F(57), 0501, sent by function key f57 

key_f58 

kf58 

Fm 

KEY_F(58), 0502, sent by function key f58 

key_f59 

kf59 

Fn 

KEY_F(59), 0503, sent by function key f59 

key_f60 

kf60 

Fo 

KEY_F(60), 0504, sent by function key f60 

key_f61 

kf61 

Fp 

KEY_F(61), 0505, sent by function key f61 

key_f62 

kf62 

Fq 

KEY_F(62), 0506, sent by function key f62 

key_f63 

kf63 

Fr 

KEY_F(63), 0507, sent by function key f63 

key_find 

kfnd 

@0 

KEY_FIND, 0552, sent by find key 

key_help 

khlp 

%l 

KEY.HELP, 0553, sent by help key 

key_home 

khome 

kh 

KEY.HOME, 0406, sent by home key 

key_ic 

kichl 

kl 

KEY_IC, 0513, sent by ins-char/enter ins-mode key 

key_il 

kill 

kA 

KEYJL, 0511, sent by insert-line key 

key_left 

kcubl 

kl 

KEY_LEFT, 0404, sent by terminal left-arrow key 

keyjl 

kll 

kH 

KEY_LL, 0533, sent by home-down key 

key_mark 

kmrk 

%2 

KEY_MARK, 0554, sent by mark key 

key_message 

kmsg 

%3 

KEY_MESS AGE, 0555, sent by message key 

key_move 

kmov 

%4 

KEY_MOVE, 0556, sent by move key 

key_next 

knxt 

%5 

KEY_NEXT, 0557, sent by next key 

key_npage 

knp 

kN 

KEY_NPAGE, 0522, sent by next-page key 

key_open 

kopn 

%6 

KEY_OPEN, 0560, sent by open key 

key_options 

kopt 

%7 

KEY_OPTIONS, 0561, sent by options key 

key_ppage 

kpp 

kP 

KEY_PPAGE, 0523, sent by previous-page key 

key_previous 

kprv 

%8 

KEY_PREVIOUS, 0562, sent by pervious-object key 

key_print 

kprt 

%9 

KEY_PRINT, 0532, sent by print or copy key 

key_redo 

krdo 

0 

KEY_REDO, 0563, sent by redo key 

key_reference 

kref 

&1 

KEY_REFERENCE, 0564, sent by reference) key 

key_refresh 

krfr 

&2 

KEY.REFRESH, 0565, sent by refresh key 

key_replace 

krpl 

&3 

KEY.REPLACE, 0566, sent by replace key 

key_restart 

krst 

&4 

KEY_RESTART, 0567, sent by restart key 

key_resume 

kres 

&5 

KEY_RESUME, 0570, sent by resume key 

key_right 

kcufl 

kr 

KEY_RIGHT, 0405, sent by terminal right-arrow key 

key_save 

ksav 

&6 

KEY_SAVE, 0571, sent by save key 

key_sbeg 

kBEG 

&9 

KEY_SBEG, 0572, sent by shifted beginning key 

key_scancel 

kCAN 

&0 

KEY_SCANCEL, 0573, sent by shifted cancel key 

key_scommand 

kCMD 

*1 

KEY_SCOMMAND, 0574, sent by shifted command key 

key_scopy 

kCPY 

*2 

KEY_SCOPY, 0575, sent by shifted copy key 

key_screate 

kCRT 

♦3 

KEY_SCREATE, 0576, sent by shifted create key 

key_sdc 

kDC 

*4 

KEY_SDC, 0577, sent by shifted delete-char key 
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Variable 

Cap- 

name 

Termcap 

Code 

key sdl 

kDL 

*5 

key_select 

kslt 

*6 

key_send 

kEND 

*7 

key_seol 

kEOL 

*8 

key_sexit 

kEXT 

*9 

key_sf 

kind 

kF 

key_sfind 

kFND 

*0 

key_shelp 

kHLP 

#1 

key_shome 

kHOM 

#2 

key_sic 

kIC 

#3 

key_sleft 

kLFT 

#4 

key_smessage 

kMSG 

%a 

key_smove 

kMOV 

%b 

key_snext 

kNXT 

%c 

key_soptions 

kOPT 

%d 

key_sprevious 

kPRV 

%e 

key_sprint 

kPRT 

%f 

key_sr 

kri 

kR 

key_sredo 

kRDO 

%g 

key_sreplace 

kRPL 

%h 

key_sright 

kRIT 

%i 

key_srsume 

kRES 

%j 

key_ssave 

kSAV 

!1 

key_ssuspend 

kSPD 

!2 

key_stab 

khts 

kT 

key_sundo 

kUND 

!3 

key_suspend 

kspd 

&7 

key_undo 

kund 

&8 

key_up 

kcuul 

ku 

keypad_local 

rmkx 

ke 

keypad_xmit 

smkx 

ks 

Iab_f0 

lfO 

10 

lab.fl 

lfl 

11 

lab_f2 

lf2 

12 

lab_f3 

lf3 

13 

lab_f4 

lf4 

14 

lab_f5 

lf5 

15 

lab_f6 

lf6 

16 

lab_f7 

in 

17 

lab_f8 

ire 

18 

lab_f9 

lf9 

19 

lab_fl0 

lflO 

la 

label_format 

fin 

Lf 
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Description 


KEY.SDL, 0600, sent by shifted delete-line key 
KEY_S ELECT, 0601, sent by select key 
KEY.SEND, 0602, sent by shifted end key 
KEY_SEOL, 0603, sent by shifted clear-line key 
KEY_SEXIT, 0604, sent by shifted exit key 
KEY_SF, 0520, sent by scroll-forward/down key 
KEY_SFIND, 0605, sent by shifted find key 
KEY_SHELP, 0606, sent by shifted help key 
KEY_SHOME, 0607, sent by shifted home key 
KEY_SIC, 0610, sent by shifted input key 
KEY.SLEFT, 0611, sent by shifted left-arrow key 
KEY.SMESSAGE, 0612, sent by shifted message kej 
KEY_SMOVE, 0613, sent by shifted move key 
KEY_SNEXT, 0614, sent by shifted next key 
KEY_SOPTTONS, 0615, sent by shifted options key 
KEY.SPREVIOUS, 0616, sent by shifted prev key 
KEY.SPRINT, 0617, sent by shifted print key 
KEY_SR, 0521, sent by scroll-backward/up key 
KEY.SREDO, 0620, sent by shifted redo key 
KEY_S REPLACE, 0621, sent by shifted replace key 
KEY.SRIGHT, 0622, sent by shifted right-arrow key 
KEY_SRSUME, 0623, sent by shifted resume key 
KEY_SSAVE, 0624, sent by shifted save key 
KEY.SSUSPEND, 0625, sent by shifted suspend key 
KEY_STAB, 0524, sent by set-tab key 
KEY_SUNDO, 0626, sent by shifted undo key 
KEY_SUSPEND, 0627, sent by suspend key 
KEY_UNDO, 0630, sent by undo key 
KEY_UP, 0403, sent by terminal up-arrow key 
Out of “keypad-transmit’ ’ mode 
Put terminal in “keypad-transmit’ ’ mode 
Labels on function key fO if not fO 
Labels on function key fl if not fl 
Labels on function key f2 if not f2 
Labels on function key f3 if not f3 
Labels on function key f4 if not f4 
Labels on function key f5 if not f5 
Labels on function key f6 if not f6 
Labels on function key f7 if not f7 
Labels on function key f8 if not f8 
Labels on function key f9 if not f9 
Labels on function key flO if not flO 
Label format 
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Variable 

Cap- 

name 

Termcap 

Code 

label_off 

rmln 

LF 

label_on 

smln 

LO 

meta_off 

rmm 

mo 

meta_on 

smm 

mm 

micro_column_address 

mhpa 

ZY 

micro_down 

mcudl 

ZZ 

micro_left 

mcubl 

Za 

micro_right 

mcufl 

Zb 

micro_row_address 

mvpa 

Zc 

micro_up 

mcuul 

Zd 

newline 

nel 

nw 

order_of_pins 

porder 

Ze 

orig_colors 

oc 

oc 

orig_pair 

op 

op 

pad_char 

pad 

pc 

parm_dch 

dch 

DC 

parm_delete_line 

dl 

DL 

parm_down_cursor 

cud 

DO 

parm_down_micro 

mcud 

Zf 

parm_ich 

ich 

IC 

parm_index 

indn 

SF 

parm_insert_line 

il 

AL 

parm_left_cursor 

cub 

LE 

parm_left_micro 

mcub 

Zg 

parm_right_cursor 

cuf 

RI 

parm_right_micro 

mcuf 

Zh 

parm_rindex 

rin 

SR 

parm_up_cursor 

cuu 

UP 

parm_up_micro 

mcuu 

Zi 

pkey_key 

pfkey 

pk 

pkey_local 

pfloc 

Pi 

pkey_xmit 

pfx 

px 

plab_norm 

pin 

pn 

print_screen 

mcO 

ps 

prtr_non 

mc5p 

pO 

prtr_off 

mc4 

Pf 

prtr_on 

mc5 

po 

pulse 

pulse 

PU 

quick_dial 

qdial 

QD 

remove_clock 

rmclk 

RC 

repeat_char 

rep 

rp 

req_for_input 

rfi 

RF 
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Description 

Turn off soft labels 

Turn on soft labels 
Turn off "meta mode" 

Turn on "meta mode" (8th bit) 

Like column_address for micro adjustment + 

Like cursor_down for micro adjustment 
Like cursor_left for micro adjustment 
Like cursor_right for micro adjustment 
Like rowaddress for micro adjustment t 
Like cursor up for micro adjustment 
Newline (behaves like cr followed by If) 

Matches software bits to print-head pins 
Set all color(-pair)s to the original ones 
Set default color-pair to the original one 
Pad character (rather than null) 

Delete #1 chars (G*) 

Delete #1 lines (G*) 

Move down #1 lines. (G*) 

Like parmdowncursor for micro adjust. (G*) 
Insert #1 blank chars (G*) 

Scroll forward #1 lines. (G) 

Add #1 new blank lines (G*) 

Move cursor left #1 spaces (G) 

Like parm_left_cursor for micro adjust, t 
Move right #1 spaces. (G*) 

Like parm_rlght_cursor for micro adjust, f 
Scroll backward #1 lines. (G) 

Move cursor up #1 lines. (G*) 

Like parm_up_cursor for micro adjust, t 

Prog funct key #1 to type string #2 

Prog funct key #1 to execute string #2 

Prog funct key #1 to xmit string #2 

Prog label #1 to show string #2 

Print contents of the screen 

Turn on the printer for #1 bytes 

Turn off the printer 

Turn on the printer 

Select pulse dialing 

Dial phone number #1, without progress detection 
Remove time-of-day clock 
Repeat char #1 #2 times (G*) 

Send next input char (for ptys) 
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Strings (corn.) 


Variable 


Cap- Termcap 
name Code 


Description 


reset l string 

reset_2string 

reset_3string 

reset_file 

restore_cursor 

row_address 

save_cursor 

scroll_forward 

scroll_reverse 


rsl 

rs2 

rs3 

if 

rc 

vpa 

sc 

ind 

ri 


rl 

r2 

r3 

rf 

rc 

cv 

sc 

sf 


Reset terminal completely to sane modes 

Reset terminal completely to sane modes 
Reset terminal completely to sane modes 
Name of file containing reset string 
Restore cursor to position of last sc 
Vertical position absolute (G) 

Save cursor position 
Scroll text up 
Scroll text down 


select_char_set 

scs 

Zj 

Select character set f 

set_attributes 

sgr 

sa 

Define the video attributes (G) #l-#9 

set_background 

setb 

Sb 

Set current background color 

set_bottom_margin 

smgb 

Zk 

Set bottom margin at current line 

set_bottom_margin_parm 

smgbp 

Z1 

Set bottom margin at line #1 f 

set_clock 

sclk 

SC 

Set time-of-day clock 

set_color_pair 

scp 

sp 

Set current color-pair 

set_foreground 

setf 

Sf 

Set current foreground colorl 

set_left_margin 

smgl 

ML 

Set left margin at current line 

set_left_margin_parm 

smglp 

Zm 

Set left margin at column #1 f 

set_right_margin 

smgr 

MR 

Set right margin at current column 

set_right_margin_parm 

smgrp 

Zn 

Set right margin at column #1 f 

set_tab 

hts 

St 

Set a tab in all rows, current column 

set_top_margin 

smgt 

Zo 

Set top margin at current line 

set_top_margin_parm 

smgtp 

Zp 

Set top margin at line #1 f 

set_window 

wind 

wi 

Current window is lines #l-#2 cols #3-#4 (G) 

start_bit_image 

sbim 

Zq 

Start printing bit image graphics f 

start_char_set_def 

scsd 

Zr 

Start definition of a character set f 

stop_bit_image 

rbim 

Zs 

End printing bit image graphics 

stop_char_set_def 

rcsd 

Zt 

End definition of a character set 

subscript_characters 

subcs 

Zu 

List of “subscript-able” characters 

supers cript_characters 

supcs 

Zv 

List of “superscript-able” characters 

tab 

ht 

ta 

Tab to next 8-space hardware tab stop 

these_cause_cr 

doer 

Zw 

Printing any of these chars causes cr 

to_status_line 

tsl 

ts 

Go to status line, col #1 (G) 

tone 

tone 

TO 

Select touch tone dialing 

underline_char 

uc 

uc 

Underscore one char and move past it 

up_half_line 

hu 

hu 

Half-line up (reverse 1/2 linefeed) 

userO 

uO 

uO 

User string 0 

userl 

ul 

ul 

User string 1 

user2 

u2 

u2 

User string 4 

user3 

u3 

u3 

User string 3 

user4 

u4 

u4 

User string 4 
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Strings (cont.) 

Variable 

Cap- 

name 

Termcap 

Code 

Description 

user5 

u5 

u5 

User string 5 

user6 

u6 

u6 

User string 6 

user7 

u7 

u7 

User string 7 

user8 

u8 

u8 

User string 8 

user9 

u9 

u9 

User string 9 

wait_tone 

wait 

WA 

Wait for dial tone 

xoff_character 

xoffc 

XF 

X-off character 

xon_character 

xonc 

XN 

X-on character 

zero_motion 

zerom 

Zx 

No motion for the subsequent character 
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name Variable Code Caf> Description 


am 

auto right margin 

am 

bw 

auto_left_margin 

bw 

ccc 

can_change 

cc 

chts 

hard_cursor 

HC 

cpix 

cpi_changes_res 

YF 

cps 

print_rate 

Ym 

crxm 

cr_cancels_micro_modem 

YB 

cwin 

create_window 

CW 

da 

memory_above 

da 

daisy 

has_print_wheel 

YC 

dclk 

display_clock 

DK 

db 

memory_below 

db 

dial 

dial_phone 

DI 

eo 

erase_overs trike 

eo 

eslok 

status_line_esc_ok 

es 

gn 

generic_type 

gn 

he 

hard_copy 

he 

his 

hue_lightness_saturation 

hi 

hs 

has_status_line 

hs 

hz 

tilde_glitch 

hz 

in 

insert_null_glitch 

in 

km 

has_meta_key 

km 

lpix 

lpi_changes_res 

YG 

mc5i 

prtr_silent 


mir 

move_insert_mode 

mi 

msgr 

move_standout_mode 

ms 

npc 

no_pad_char 

NP 

nrrmc 

non_rev_rmcup 

NR 

nxon 

needs_xon_xoff 

nx 

os 

over_strike 

os 

sam 

semi_auto_right_margin 

YE 

ul 

transparent_underline 

ul 

xenl 

eat_newline_glitch 

xn 

xhp 

ceol_standout_glitch 

xs 

xhpa 

col_addr_glitch 

YA 

xon 

xon_xoff 

xo 

xsb 

no_esc_ctlc 

xb 

xt 

dest_tabs_magic_smso 

xt 

xvpa 

row_addr_glitch 

YD 


Terminal has automatic margins 
cubl wraps from column 0 to last column 
Terminal can re-define existing color 
Cursor is hard to see 

Changing character pitch changes resolution 

Print rate in characters per second 

Using cr turns off micro mode 

Define win #1 to go from #2,#3 to #4,#5 

Display may be retained above the screen 

Printer needs operator to change character set 

Display time-of-day clock 

Display may be retained below the screen 

Dial phone number #1 

Can erase overstrikes with a blank 

Escape can be used on the status line 

Generic line type (e.g., dialup, switch) 

Hardcopy terminal 

Terminal uses only HLS color notation (Tektronix) 
Has extra "status line" 

Hazeltine; can’t print tilde (~) 

Insert mode distinguishes nulls 
Has a meta key (shift, sets parity bit) 

Changing line pitch changes resolution 

Safe to move while in insert mode 
Safe to move in standout modes 
Pad character doesn’t exist 
smcup does not reverse rmcup 
Padding won’t work, xon/xoff required 
Terminal overstrikes on hard-copy terminal 
Printing in last column causes cr 
Underline character overstrikes 
Newline ignored after 80 columns {Concept) 
Standout not erased by overwriting (hp) 

Only positive motion for hpa/mhpa caps 
Terminal uses xon/xoff handshaking 
Beehive (fl=escape, f2=ctrl C) 

Destructive tabs, magic smso char (tl061) 

Only positive motion for vpa/mvpa caps 
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Numbers 


Cap- 

name 

Variable 

Termcap 

Code 

bufsz 

buffer_capacity 

Ya 

colors 

max_colors 

Co 

cols 

columns 

CO 

cps 

print_rate 

Ym 

it 

init_tabs 

it 

lh 

label_height 

lh 

lines 

lines 

li 

lm 

lines_of_memory 

lm 

lw 

label_width 

lw 

maddr 

max_micro_address 

Yd 

mcs 

micro_col_size 

Yf 

mjump 

max_micro_jump 

Ye 

mis 

micro_line_size 

Yg 

ncv 

no_color_video 

NC 

nlab 

numjabels 

N1 

npins 

number_of_pins 

Yh 

ore 

output_res_char 

Yi 

orhi 

output_res_horz_inch 

Yk 

orl 

output_res_line 

Yj 

orvi 

output_res_vert_inch 

Yl 

pairs 

max_pairs 

pa 

pb 

padding_baud_rate 

pb 

spinh 

dot_horz_spacing 

Yc 

spinv 

dot_vert_spacing 

Yb 

vt 

virtual_terminal 

vt 

widcs 

wide_char_size 

Yn 

wsl 

width_status_line 

ws 

xmc 

magic_cookie_glitch 

Sg 


Description 

Number of bytes buffered before printing 

Maximum number of colors on the screen 

Number of columns in a line 

Average print rate in characters per second 

Tabs initially every # spaces 

Number of rows in each label 

Number of lines on a screen or a page 

Lines of memory if > lines; 0 means varies 

Number of columns in each label 

Maximum value in micro_..._address 

Character step size when in micro mode 

Maximum value in parm_..._micro 

Line step size when in micro mode 

Video attributes that can’t be used with colors 

Number of labels on screen (start at 1) 

Number of pins in print-head 
Horizontal resolution in units per character 
Horizontal resolution in units per inch 
Vertical resolution in units per line 
Vertical resolution in units per inch 
Maximum number of color-pairs on the screen 
Lowest baud rate where padding needed 
Spacing of dots horizontally in dots per inch 
Spacing of pins vertically in pins per inch 
Virtual terminal number (UNIX system) 
Character step size when in double wide mode 
Number of columns in status line 
Number of blank characters left by smso or rmso 
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Cap- 

name 

Variable 

Termcap 

Code 

Description 

acsc 

acs chars 

ac 

Graphic charset pairs aAbBcC - def=vtl00 

bel 

bell 

bl 

Audible signal (bell) 

blink 

enter_bl ink_mode 

mb 

Turn on blinking 

bold 

enter_bold_mode 

md 

Turn on bold (extra bright) mode 

cbt 

back_tab 

bt 

Back tab 

chr 

change_res_horz 

ZC 

Change horizontal resolution f 

civis 

cursorjnvisible 

vi 

Make cursor invisible 

clear 

clear_screen 

cl 

Clear screen and home cursor (+) 

cmdch 

command_character 

CC 

Terminal settable cmd character in prototype 

cnorm 

cursor_normal 

ve 

Make cursor appear normal (undo vs/vi) 

cpi 

change_char_pitch 

ZA 

Change number of characters per inch t 

cr 

carriage_retum 

cr 

Carriage return (+) 

csnm 

char_set_names 

Zy 

List of character set names 

csr 

change_scroll_region 

cs 

Change to lines #1 through #2 (vtlOO) (G) 

cub 

parm_left_cursor 

LE 

Move cursor left #1 spaces (G) 

cubl 

cursorjeft 

le 

Move left one space. 

cud 

parm_down_cursor 

DO 

Move down #1 lines. (G*) 

cuf 

parm_right_cursor 

RI 

Move right #1 spaces. (G*) 

cufl 

cursor_right 

nd 

Non-destructive space (cursor or carriage right) 

cup 

cursor_address 

cm 

Move to row #1 col #2 (G) 

cuu 

parm_up_cursor 

UP 

Move cursor up #1 lines. (G*) 

cvr 

change_res_vert 

ZD 

Change vertical resolution f 

cwis 

cursor_visible 

vs 

Make cursor very visible 

dch 

parm_dch 

DC 

Delete #1 chars (G*) 

dchl 

delete_character 

dc 

Delete character (+) 

defc 

define_char 

ZE 

Define a character in a character set 

dim 

enter_dim_mode 

mh 

Turn on half-bright mode 

dl 

delete_line 

dll 

Delete line («■) 

dl 

parm_delete_line 

DL 

Delete #1 lines (G*) 

do 

cursor_down 

do 

Down one line 

doer 

these_cause_cr 

Zw 

Printing any of these chars causes cr 

dsl 

dis_status_line 

ds 

Disable status line 

ech 

erase_chars 

ec 

Erase #1 characters (G) 

ed 

clr_eos 

cd 

Clear to end of display (*) 

el 

clr_eol 

ce 

Clear to end of line 

ell 

clr_bol 

cb 

Clear to beginning of line, inclusive 

enacs 

ena_acs 

eA 

Enable alternate character set 

ff 

form_feed 

ff 

Hardcopy terminal page eject (*) 

flash 

flash_screen 

vb 

Visible bell (may not move cursor) 

fln 

label_format 

Lf 

Label format 

fsl 

from_status_line 

fs 

Return from status line 

hd 

down_half_line 

hd 

Half-line down (forward 1/2 linefeed) 

home 

cursor_home 

ho 

Home cursor (if no cup) 
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Variable 

Cap- 

name 

Termcap 

Code 

Description 

hook 

flash_hook 

fh 

Flash the switch hook 

hpa 

column_address 

ch 

Horizontal position absolute (G) 

ht 

tab 

ta 

Tab to next 8-space hardware tab stop 

hts 

set tab 

st 

Set a tab in all rows, current column 

hu 

up_half_line 

hu 

Half-line up (reverse 1/2 linefeed) 

hup 

hangup 

HU 

Hang-up phone 

ich 

parm_ich 

IC 

Insert #1 blank chars (G*) 

ichl 

insert_character 

ic 

Insert character 

if 

init file 

if 

Name of initialization file 

il 

parm_insert_line 

AL 

Add #1 new blank lines (G*) 

ill 

insert_line 

al 

Add new blank line (*) 

ind 

scroll_forward 

sf 

Scroll text up 

indn 

parm_index 

SF 

Scroll forward #1 lines. (G) 

initc 

initialize_color 

Ic 

Initialize the definition of color 

initp 

initialize_pair 

Ip 

Initialize color-pair 

in vis 

enter_secure_mode 

mk 

Turn on blank mode (characters invisible) 

ip 

insert_padding 

ip 

Insert pad after character inserted (*) 

iprog 

init_prog 

iP 

Path name of program for initialization 

isl 

init_l string 

il 

Terminal or printer initialization string 

is2 

init_2string 

is 

Terminal or printer initialization string 

is3 

init_3string 

i3 

Terminal or printer initialization string 

kBEG 

key_sbeg 

&9 

KEY_SBEG, 0572, sent by shifted beginning key 

kCAN 

key_scancel 

&0 

KEY_SCANCEL, 0573, sent by shifted cancel key 

kCMD 

key_scommand 

*1 

KEY_SCOMMAND, 0574, sent by shifted command key 

kCPY 

key_scopy 

*2 

KEY_SCOPY, 0575, sent by shifted copy key 

kCRT 

key_screate 

*3 

KEY_SCREATE, 0576, sent by shifted create key 

kDC 

key_sdc 

*4 

KEY_SDC, 0577, sent by shifted delete-char key 

kDL 

key_sdl 

*5 

KEY.SDL, 0600, sent by shifted delete-line key 

kEND 

key_send 

*7 

KEY_SEND, 0602, sent by shifted end key 

kEOL 

key_seol 

*8 

KEY_SEOL, 0603, sent by shifted clear-line key 

kEXT 

key_sexit 

*9 

KEY_SEXrr, 0604, sent by shifted exit key 

kFND 

key_sfind 

*0 

KEY_SFTND, 0605, sent by shifted find key 

kHLP 

key_shelp 

#1 

KEY_SHELP, 0606, sent by shifted help key 

kHOM 

key_shome 

#2 

KEY_SHOME, 0607, sent by shifted home key 

kIC 

key_sic 

#3 

KEY_SIC, 0610, sent by shifted input key 

kLFT 

key_sleft 

#4 

KEY_SLEFT, 0611, sent by shifted left-arrow key 

kMOV 

key_smove 

b 

KEY_SMOVE, 0613, sent by shifted move key 

kMSG 

key_smessage 

%a 

KEY_SMESSAGE, 0612, sent by shifted message key 

kNXT 

key_snext 

%c 

KEY_SNEXT, 0614, sent by shifted next key 

kOPT 

key_soptions 

%d 

KEY_SOPTTONS, 0615, sent by shifted options key 

kPRT 

key_sprint 

%f 

KEY_SPRINT, 0617, sent by shifted print key 

kPRV 

key_sprevious 

%e 

KEY_SPREVIOUS, 0616, sent by shifted prev key 

kRDO 

key_sredo 

%g 

KEY_SREDO, 0620, sent by shifted redo key 

kRES 

key_srsume 

%j 

KEY_SRSUME, 0623, sent by shifted resume key 
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Variable 

Cap- 

name 

Termcap 

Code 

kRIT 

key_sright 

%i 

kRPL 

key_sreplace 

%h 

kSAV 

key_ssave 

!1 

kSPD 

key_ssuspend 

!2 

kUND 

key_sundo 

!3 

kal 

key_al 

K1 

ka3 

key_a3 

K3 

kb2 

key_b2 

K2 

kbeg 

key_beg 

@1 

kbs 

key_backspace 

kb 

kcl 

key_cl 

K4 

kc3 

key_c3 

K5 

kcan 

key_cancel 

@2 

kcbt 

key_btab 

kB 

kclo 

key_close 

@3 

kclr 

key_clear 

kC 

kcmd 

key_command 

@4 

kcpy 

key_copy 

@5 

kcrt 

key_create 

@6 

kctab 

key_ctab 

kt 

kcubl 

key_left 

kl 

kcudl 

key_down 

kd 

kcufl 

key_right 

kr 

kcuul 

key_up 

ku 

kdchl 

key_dc 

kD 

kdll 

key_dl 

kL 

ked 

key_eos 

ked 

kel 

key_eol 

kE 

kend 

key_end 

@7 

kent 

key_enter 

@8 

kext 

key_exit 

@9 

kfO 

key_f0 

kO 

kfl 

key_fl 

kl 

kflO 

key_fl0 

k; 

kfl 1 

key_f 11 

Fl 

kfl 2 

key_fl2 

F2 

kfl 3 

key_fl3 

F3 

kfl 4 

key_fl4 

F4 

kfl 5 

key_fl5 

F5 

kfl 6 

key_f16 

F6 

kfl 7 

key_fl7 

F7 

kfl 8 

key_f 18 

F8 

kfl 9 

key_fl9 

F9 

kf2 

key_f2 

k2 


Description 


KEY_S RIGHT, 0622, sent by shifted right-airow key 
KEY_SREPLACE, 0621, sent by shifted replace key 
KEY_SS AVE, 0624, sent by shifted save key 
KEY_SSUSPEND, 0625, sent by shifted suspend key 
KEY_SUNDO, 0626, sent by shifted undo key 
KEY_A1,0534, upper left of keypad 
KEY_A3,0535, upper right of keypad 
KEY_B2,0536, center of keypad 
KEY_BEG, 0542, sent by beg(inning) key 
KEY_BACKSPACE, 0407, sent by backspace key 
KEY_C1,0537, lower left of keypad 
KEY_C3,0540, lower right of keypad 
KEY_CANCEL, 0543, sent by cancel key 
KEY_BTAB, 0541, sent by back-tab key 
KEY_CLOSE, 0544, sent by close key 
KEY_CLEAR, 0515, sent by dear-screen or erase key 
KEY_COMMAND, 0545, sent by cmd (command) key 
KEY_COPY, 0546, sent by copy key 
KEY_CREATE, 0547, sent by create key 
KEY_CTAB, 0525, sent by clear-tab key 
KEY_LEFT, 0404, sent by terminal left-arrow key 
KEY_DOWN, 0402, sent by terminal down-arrow key 
KEY_RIGHT, 0405, sent by terminal right-arrow key 
KEY_UP, 0403, sent by terminal up-arrow key 
KEY_DC, 0512, sent by delete-character key 
KEY_DL, 0510, sent by delete-line key 
KEY_EOS, 0516, sent by clear-to-end-of-screen key 
KEY_EOL, 0517, sent by clear-to-end-of-line key 
KEY_END, 0550, sent by end kee 
KEY_ENTER, 0527, sent by enter/send key 
KEY.EXIT, 0551, sent by exit key 
KEY_F(0), 0410, sent by function key fO 
KEY_F(C), 0411, sent by function key fl 
KEY_F(ADM), 0422, sent by function key flO 
KEY_F(ADM), 0423, sent by function key fll 
KEY_F(ADM), 0424, sent by function key fl2 
KEY_F(ADM), 0425, sent by function key fl3 
KEY_F(ADM), 0426, sent by function key fl4 
KEY_F(ADM), 0427, sent by function key fl5 
KEY_F(ADM), 0430, sent by function key fl6 
KEY_F(ADM), 0431, sent by function key fl7 
KEY_F(ADM), 0432, sent by function key fl8 
KEY_F(ADM), 0433, sent by function key fl9 
KEY_F(S), 0412, sent by function key f2 
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Variable 

Cap- 

name 

Termcap 

Code 

Description 

kf20 

key_f20 

FA 

KEY_F(20), 0434, sent by function key f20 

kf21 

key_f21 

FB 

KEY_F(21), 0435, sent by function key f21 

kf22 

key_f22 

FC 

KEY_F(22), 0436, sent by function key f22 

kf23 

key_f23 

FD 

KEY_F(23), 0437, sent by function key f23 

kf24 

key_f24 

FE 

KEY_F(24), 0440, sent by function key f24 

kf25 

key_f25 

FF 

KEY_F(25), 0441, sent by function key f25 

kf26 

key_f26 

FG 

KEY_F(26), 0442, sent by function key f26 

kf27 

key_f27 

FH 

KEY_F(27), 0443, sent by function key f27 

kf28 

key_f28 

FI 

KEY_F(28), 0444, sent by function key f28 

kf29 

key_f29 

FJ 

KEY_F(29), 0445, sent by function key f29 

kf3 

key_f3 

k3 

KEY_F(S), 0413, sent by function key f3 

kf30 

key_f30 

FK 

KEY_F(S), 0446, sent by function key f30 

kf31 

key_f31 

FL 

KEY_F(S), 0447, sent by function key f31 

kB2 

key_f32 

FM 

KEY_F(S), 0450, sent by function key f32 

k03 

key_f33 

FN 

KEY_F(ADM), 0451, sent by function key fl3 

kf34 

key_f34 

FO 

KEY_F(S), 0452, sent by function key 04 

kB5 

key_f35 

FP 

KEY_F(S), 0453, sent by function key 05 

kf36 

key_f36 

FQ 

KEY_F(S), 0454, sent by function key 06 

kf37 

key_f37 

FR 

KEY_F(S), 0455, sent by function key 07 

kf38 

key_f38 

FS 

KEY_F(S), 0456, sent by function key 08 

kf39 

key_f39 

FT 

KEY_F(S), 0457, sent by function key 09 

kf4 

key_f4 

k4 

KEY_F(F), 0414, sent by function key f4 

kf40 

key_f40 

FU 

KEY_F(40), 0460, sent by function key f40 

kf41 

key_f41 

FV 

KEY_F(41), 0461, sent by function key f41 

kf42 

key_f42 

FW 

KEY_F(42), 0462, sent by function key f42 

kf43 

key_f43 

FX 

KEY_F(43), 0463, sent by function key f43 

kf44 

key_f44 

FY 

KEY_F(44), 0464, sent by function key f44 

kf45 

key_f45 

FZ 

KEY_F(45), 0465, sent by function key f45 

kf46 

key_f46 

Fa 

KEY_F(46), 0466, sent by function key f46 

kf47 

key_f47 

Fb 

KEY_F(47), 0467, sent by function key f47 

kf48 

key_f48 

Fc 

KEY_F(48), 0470, sent by function key f48 

kf49 

key_f49 

Fd 

KEY_F(49), 0471, sent by function key f49 

kf5 

key_f5 

k5 

KEY_F(M), 0415, sent by function key f5 

kf50 

key_f50 

Fe 

KEY_F(50), 0472, sent by function key f50 

kf51 

key_f51 

Ff 

KEY_F(51), 0473, sent by function key f51 

kf52 

key_f52 

Fg 

KEY_F(52), 0474, sent by function key f52 

kf53 

key_f53 

Fh 

KEY_F(53), 0475, sent by function key f53 

kf54 

key_f54 

Fi 

KEY_F(54), 0476, sent by function key f54 

kf55 

key_f55 

Fj 

KEY_F(55), 0477, sent by function key f55 

kf56 

key_f56 

Fk 

KEY_F(56), 0500, sent by function key f56 

kf57 

key_f57 

FI 

KEY_F(57), 0501, sent by function key f57 

kf58 

key_f58 

Fm 

KEY_F(58), 0502, sent by function key f58 

kf59 

key_f59 

Fn 

KEY_F(59), 0503, sent by function key f59 

kf6 

key_f6 

k6 

KEY_F(6), 0416, sent by function key f6 


March 15,1989 TERMINFO-19 



TERMINFO (M) 
Strings (corn.) 


TERMINFO (M) 


Variable 

Cap- 

name 

Termcap 

Code 

kf60 

key_f60 

Fo 

kf61 

key_f61 

Fp 

kf62 

key_f62 

Fq 

kf63 

key_f63 

Fr 

kn 

key_f7 

k7 

kf8 

key_f8 

k8 

kf9 

key_f9 

k9 

kftid 

key_find 

@0 

khlp 

key_help 

%l 

khome 

key_home 

kh 

khts 

key_stab 

kT 

kichl 

key_ic 

kl 

kill 

key_il 

kA 

kind 

key_sf 

kF 

kll 

key_ll 

kH 

kmov 

key_move 

%4 

kmrk 

key_mark 

%2 

kmsg 

key_message 

%3 

knp 

key_npage 

kN 

knxt 

key_next 

%5 

kopn 

key_open 

%6 

kopt 

key_options 

%7 

kpp 

key_ppage 

kP 

kprt 

key_print 

%9 

kprv 

key_previous 

%8 

krdo 

key_redo 

%0 

kref 

key_reference 

&1 

kres 

key_resume 

&5 

krfr 

key_refresh 

&2 

kri 

key_sr 

kR 

krmir 

key_eic 

kM 

krpl 

key_replace 

&3 

krst 

key_restart 

&4 

ksav 

key_save 

&6 

kslt 

key_select 

♦6 

kspd 

key_suspend 

&7 

ktbc 

key_catab 

ka 

kund 

key_undo 

&8 

lfO 

lab_f0 

10 

lfl 

lab_fl 

11 

lflO 

lab.flO 

la 

lf2 

lab_f2 

12 

lf3 

lab_f3 

13 

lf4 

lab_f4 

14 


Description 


KEY_F(60), 0504, sent by function key f60 
KEY_F(61), 0505, sent by function key f61 
KEY_F(62), 0506, sent by function key f62 
KEY_F(63), 0507, sent by function key f63 
KEY_F(7), 0417, sent by function key f7 
KEY_F(8), 0420, sent by function key f8 
KEY_F(9), 0421, sent by function key f9 
KEY_FIND, 0552, sent by find key 
KEY_HELP, 0553, sent by help key 
KEY_HOME, 0406, sent by home key 
KEY_STAB, 0524, sent by set-tab key 
KEY_IC, 0513, sent by ins-char/enter ins-mode key 
KEY_IL, 0511, sent by insert-line key 
KEY_SF, 0520, sent by scroll-forward/down key 
KEY_LL, 0533, sent by home-down key 
KEY_MOVE, 0556, sent by move key 
KEY_MARK, 0554, sent by mark key 
KEY_MESSAGE, 0555, sent by message key 
KEY_NPAGE, 0522, sent by next-page key 
KEY_NEXT, 0557, sent by next-object key 
KEY_OPEN, 0560, sent by open key 
KEY_OPTTONS, 0561, sent by options key 
KEY_PPAGE, 0523, sent by previous-page key 
KEY_PRINT, 0532, sent by print or copy key 
KEY_PREVIOUS, 0562, sent by previous-object key 
KEY_REDO, 0563, sent by redo key 
KEY_REFERENCE, 0564, sent by reference) key 
KEY_RESUME, 0570, sent by resume key 
KEY_REFRESH, 0565, sent by refresh key 
KEY_SR, 0521, sent by scroll-backward/up key 
KEY_EIC, 0514, sent by rmir or smir in insert mode 
KEY_REPLACE, 0566, sent by replace key 
KEY_RESTART, 0567, sent by restart key 
KEY_SAVE, 0571, sent by save key 
KEY_S ELECT, 0601, sent by select key 
KEY_SUSPEND, 0627, sent by suspend key 
KEY_CATAB, 0526, sent by clear-all-tabs key 
KEY_UNDO, 0630, sent by undo key 
Labels on function key fO if not fO 
Labels on function key fl if not fl 
Labels on function key flO if not flO 
Labels on function key f2 if not f2 
Labels on function key f3 if not f3 
Labels on function key f4 if not f4 
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Strings (cont.) 


Variable 


Cap- 

name 


Termcap 

Code 


lf5 

lab_f5 

15 

lf6 

lab_f6 

16 

in 

lab_f7 

17 

lf8 

lab_f8 

18 

lf9 

lab_f9 

19 

11 

cursor_to_ll 

11 

lpi 

change_line_pitch 

ZB 

ma 

max_attributes 

ma 

mcO 

print_screen 

ps 

mc4 

prtr_o ff 

Pf 

mc5 

prtr_on 

po 

mc5p 

prtr_non 

pO 

mcub 

parm_left_micro 

Zg 

mcubl 

microjeft 

Za 

mcud 

parm_down_micro 

Zf 

mcudl 

micro_down 

ZZ 

mcuf 

parm_right_micro 

Zh 

mcufl 

micro_right 

Zb 

mcuu 

parm_up_micro 

Zi 

mcuul 

micro_up 

Zd 

mgc 

clear_margins 

MC 

mhpa 

micro_column_address 

ZY 

mrcup 

cursor_mem_address 

CM 

mvpa 

micro_row_address 

Zc 

ndscr 

non_dest_scroll_region 

ND 

nel 

newline 

nw 

oc 

orig_colors 

oc 

op 

orig_pair 

op 

pad 

pad_char 

pc 

pause 

fixed_pause 

PA 

pfkey 

pkey_key 

pk 

pfloc 

pkey_local 

Pi 

pfx 

pkey_xmit 

px 

pin 

plab_norm 

pn 

porder 

order_of_pins 

Ze 

prot 

enter_protected_mode 

mp 

pulse 

pulse 

PU 

qdial 

quick_dial 

QD 

rbim 

stop_bit_image 

Zs 

re 

restore_cursor 

re 

resd 

stop_char_set_def 

Zt 

rep 

repeat_char 

rp 

rev 

enter_reverse_mode 

mr 

rf 

reset_file 

rf 


Description 

Labels on function key f5 if not f5 
Labels on function key f6 if not f6 
Labels on function key f7 if not f7 
Labels on function key f8 if not f8 
Labels on function key f9 if not f9 
Last line, first column (if no cup) 

Change number of lines per inch f 
Maximum combined video attributes terminal can display 
Print contents of the screen 
Turn off the printer 
Turn on the printer 
Turn on the printer for #1 bytes 
Like parm_left_cursor for micro adjust, f 
Like cursor_left for micro adjustment 
Like parm down_cursor for micro adjust. (G*) 

Like cursor_down for micro adjustment 
Like parm_right_cursor for micro adjust, f 
Like cursor_right for micro adjustment 
Like parm up cursor for micro adjust, f 
Like cursor_up for micro adjustment 
Clear all margins (top, bottom, and sides) 

Like column_address for micro adjustment f 
Memory relative cursor addressing (G) 

Like row address for micro adjustment f 
Scrolling region is non-destructive 
Newline (behaves like cr followed by If) 

Set all color(-pair)s to the original ones 
Set default color-pair to the original one 
Pad character (rather than null) 

Pause for 2-3 seconds 
Prog fund key #1 to type string #2 
Prog fund key #1 to execute string #2 
Prog fund key #1 to xmit string #2 
Prog label #1 to show string #2 
Matches software bits to print-head pins 
Turn on protected mode 
Select pulse dialing 

Dial phone number #1, without progress detection 
End printing bit image graphics 
Restore cursor to position of last sc 
End definition of a character set 
Repeat char #1 #2 times (G*) 

Turn on reverse video mode 
Name of file containing reset string 
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Strings (cont.) 


Variable 

Cap- 

name 

Termcap 

Code 

Description 

rfi 

req for input 

RF 

Send next input char (for ptys) 

ri 

scroll_reverse 

sr 

Scroll text down 

rin 

parm_rindex 

SR 

Scroll backward #1 lines. (G) 

ritm 

exit_italics_mode 

ZR 

Disable italics 

rim 

exit_leftward_mode 

ZS 

Enable rightward (normal) carriage motion 

rmacs 

exit_alt_charset_mode 

ae 

End alternate character set 

imam 

exit_am_mode 

RA 

Turn off automatic margins 

rmclk 

remove_clock 

RC 

Remove time-of-day clock 

rmcup 

exit_ca_mode 

te 

String to end programs that use cup 

rmdc 

exit_delete_mode 

ed 

End delete mode 

rmicm 

exit_micro_mode 

ZT 

Disable micro motion capabilities 

rmir 

exit_insert_mode 

ei 

End insert mode 

rmkx 

keypad_local 

ke 

Out of “keypad-transmit’ ’ modey 

rmln 

label_off 

LF 

Turn off soft labels 

rmm 

meta_off 

mo 

Turn off "meta mode" 

rmp 

char_padding 

rP 

Like ip but when in replace mode 

rmso 

exit_standout_mode 

se 

End standout mode 

rmul 

exi t_underl ine_mode 

ue 

End underscore mode 

rmxon 

exit_xon_mode 

RX 

Turn off xon/xoff handshaking 

rsl 

reset_l string 

rl 

Reset terminal completely to sane modes 

rs2 

reset_2string 

r2 

Reset terminal completely to sane modes 

rs3 

reset_3string 

r3 

Reset terminal completely to sane modes 

rshm 

exit_shadow_mode 

ZU 

Disable shadow printing 

rsubm 

exit_subscript_mode 

ZV 

Disable subscript printing 

rsupm 

exit_superscript_mode 

ZW 

Disable superscript printing 

rum 

exit_upward_mode 

ZX 

Enable downward (normal) carriage motion 

rwidm 

exit_doublewide_mode 

ZQ 

Disable double wide printing 

sbim 

start_bit_image 

Zq 

Start printing bit image graphics f 

sc 

save_cursor 

sc 

Save cursor position 

sclk 

set_clock 

SC 

Set time-of-day clock 

scp 

set_color_pair 

sp 

Set current color-pair 

scs 

select_char_set 

Zj 

Select character set f 

scsd 

start_char_set_def 

Zr 

Start definition of a character set f 

sdrfq 

enter_draft_quality 

ZG 

Set draft quality print 

setb 

set_background 

Sb 

Set current background color 

setf 

set_foreground 

Sf 

Set current foreground color 

sgr 

set_attributes 

sa 

Define the video attributes #l-#9 (G) 

sgrO 

exi t_attribute_mode 

me 

Turn off all attributes 

sitm 

enter_italics_mode 

ZH 

Enable italics 

slm 

enter_leftward_mode 

ZI 

Enable leftward carriage motion 

smacs 

enter_alt_charset_mode 

as 

Start alternate character set 

smam 

enter_am_mode 

SA 

Turn on automatic margins 

smcup 

enter_ca_mode 

ti 

String to begin programs that use cup 

smdc 

enter_delete_mode 

dm 

Delete mode (enter) 
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Strings (cont.) 

Variable < ' a ^ 
name 

Termcap 

Code 

Description 

smgb 

set_bottom_margin 

Zk 

Set bottom margin at current line 

smgbp 

set_bottom_margin_parm 

Z1 

Set bottom margin at line #1 1 

smgl 

set_left_margin 

ML 

Set left margin at current line 

smglp 

set_left_margin_parm 

Zm 

Set left margin at column #11 

smgr 

set_right_margin 

MR 

Set right margin at current column 

smgrp 

set_right_margin_parm 

Zn 

Set right margin at column #1 f 

smgt 

set_top_margin 

Zo 

Set top margin at current line 

smgtp 

set_top_margin_parm 

Zp 

Set top margin at line #1 f 

smicm 

enter_micro_mode 

ZJ 

Enable micro motion capabilities 

smir 

enter_insert_mode 

im 

Insert mode (enter) 

smkx 

keypad_xmit 

ks 

Put terminal in “keypad-transmit’ ’ mode 

smln 

label_on 

LO 

Turn on soft labels 

smm 

meta_on 

mm 

Turn on "meta mode" (8th bit) 

smso 

enter_standout_mode 

so 

Begin standout mode 

smxon 

enter_xon_mode 

SX 

Turn on xon/xoff handshaking 

snlq 

enter_near_letter_quality 

ZK 

Set near-letter quality print 

snrmq 

enter_normal_quali ty 

ZL 

Set normal quality print 

sshm 

enter_shadow_mode 

ZM 

Enable shadow printing 

ssubm 

enter_subscript_mode 

ZN 

Enable subscript printing 

ssupm 

enter_superscript_mode 

ZO 

Enable superscript printing 

subcs 

subscript_characters 

Zu 

List of “subscript-able” characters 

sum 

enter_upward_mode 

ZP 

Enable upward carriage motion 

supcs 

superscript_characters 

Zv 

List of “superscript-able” characters 

swidm 

enter_doublewide_mode 

ZF 

Enable double wide printing 

tbc 

clear_all_tabs 

ct 

Clear all tab stops 

tone 

tone 

TO 

Select touch tone dialing 

tsl 

to_status_line 

ts 

Go to status line, col #1 (G) 

uO 

userO 

uO 

User string 0 

ul 

userl 

ul 

User string 1 

u2 

user2 

u2 

User string 2 

u3 

user3 

u3 

User string 3 

u4 

user4 

u4 

User string 4 

u5 

user5 

u5 

User string 5 

u6 

user6 

u6 

User string 6 

u7 

user7 

u7 

User string 7 

u8 

user8 

u8 

User string 8 

u9 

user9 

u9 

User string 9 
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Strings 

Variable 

(cont.) 

Cap- 

name 

Termcap 

Code 

Description 

UC 

underline char 

uc 

Underscore one char and move past it 

up 

cursor_up 

cuul 

Upline (cursor up) 

vpa 

row_address 

cv 

Vertical position absolute (G) 

wait 

wait_tone 

WA 

Wait for dial tone 

wind 

set_window 

wi 

Current window is lines #l-#2 cols #3-#4 (G) 

wingo 

goto_window 

WG 

Got to window #1 

wnum 

maximum_windows 

MW 

Maximum number of definable windows 

xoffc 

xoff_character 

XF 

X-off character 

xonc 

xon_character 

XN 

X-on character 

zerom 

zero_motion 

Zx 

No motion for the subsequent character 

Sample Entry 




The following entry, which describes the AT&T 610 terminal, is 
among the more complex entries in the terminfo file as of this writing. 

610 | 610bct | ATT610 | att610 | AT&T 610; 80 column; 98key keyboard 
am, eslok, hs, mir, msgr, xenl, xon, 
cols#80, it#8, lh#2, lines#24, lw#8, nlab#8, wsl#80, 
acsc="aaffggj jkkllmmnnooppcfqrrssttuuwwwxxyyzz{ { | | }}—, 
bel^G, blink=\E[5m, bold=\E[Iirv cbt=\E [Z, 
civis=\E[7251, clear=\E[H\E[J, cnorm=\E[?25h\E[?121, 
cr=\r, csr=\E [%i%pl%d; %p2%dr, cub=\E[%pl%dD, cubl=\b, 

Cud=\E [%pl%dB, cudl=\E[B, Cuf=\E [%pl%dc, cuf 1=\E [C, 
cup=\E [%i%pl%d; %p2%dH, cuu=\E[%pl%dA, cuul=\E[A, 
cwis=\E [ 712; 25h, dch=\E[%pl%dP, dchl=\E [P, dim=\E[2m, 
dl=\E[%pl%dM, dll=\E [M, ed=\E [J, el=\E[K, ell=\E[lK, 
flash=\E [75h$<200>\E [751, fsl=\E8, hare=\E[H, ht=\t, 
ich=\E [ %pl%d@, il=\E[%pl%dL, ill=\E [L, ind=\ED, 
invis=\E[8m, 

isl=\E[8;0 | \E[73;4;5;13;151\E[13;201\E[?7h\E[12h\E(B\E)0, 
is2=\E [OrrfO, is3=\E(B\E)0, kLFT=\E[\s@, kRIT=\E[\sA, 
kbs=\b, kcbt=\E [Z, kclr=\E[2j, kcubl=\E[D, kcudl=\E [B, 
kcuf 1=\E [C, kcuul=\E[A, kfl=\EOc, kfl0=\ENp, 
kfll=\ENq, kfl2=\ENr, kfl3=\ENs, kfl4=\ENt, kf2=\EOd, 
kf3=\EOe, kf4=\EOf, kf5=\EOg, kf6=\EOh, kf7=\EOi, 
kf8=\EOj, kf9=\ENo, khcme=\E[H, kind=\E[S, kri=\E[T, 

11=\E[24H, mc4=\E[?4i, mc5=\E[?5i, nel=\EE, 
pfx=\E [%pl%d; %p2%l%02dq\s\s\sF%pl%ld\s\s\s\s\s 
\s\s\s\s\s\s%p2%s, 

pln=\E[%pl%d;0;0;0q%p2%:-16.16s, rc=\E8, rev=\E[7m, 
ri=\EM, rmacs=~0, rmir=\E[41, rmln=\E[2p, rmso=\E [m, 
rmul=\E[m, rs2=\Ec\E[731, sc=\E7, 

sgr=\E[0%7%p6%t;l%;%?%p5%t;2%;%?%p2%t;4%;%?%p4%t;5%; 

%7%p3%pl% | %t;7%;%?%p7%t;8%;m%?%p9%t~N%e~0%;, 

sgr0=\E [rrf 0, smacs=~N, smir=\E[4h, smln=\E[p, 
smso=\E[7m, smul=\E[4m, tsl=\E7\E [25;%i%pl%dx, 

Types of Capabilities in the Sample Entry 

The sample entry shows the formats for the three types of terminfo 
capabilities listed: Boolean, Numeric, and String. The names of 
Boolean capabilities are often listed as abbreviations or acronyms, 
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such as am (short for "automatic margins") in the sample entry. 
("Automatic margins" is a short description of an automatic return and 
linefeed when the end of a line is reached.) 

Numeric capabilities are followed by the character *#’ and then the 
value. Thus, in the sample, cols (which shows the number of columns 
available on a terminal) gives the value 80 for the AT&T 610. (Values 
for numeric capabilities may be specified in decimal, octal or hexade¬ 
cimal, using normal C conventions.) 

Finally, string-valued capabilities such as el (clear to end of line 
sequence) are listed by a two- to five-character capname, an ‘=\ and a 
string ended by the next occurrence of a comma. A delay in mil¬ 
liseconds may appear anywhere in such a capability, enclosed in $<..> 
brackets, as in el=\EK$<3>. Padding characters are supplied by 
tputsQ. The delay can be any of the following: a number (5), a 
number followed by a (5*), a number followed by a 7’ (5/), or a 
number followed by both (5*/). A ’ shows that the padding required 
is proportional to the number of lines affected by the operation, and 
the amount given is the per-affected-unit padding required. (In the 
case of insert characters, the factor is still the number of lines affected. 
This is always 1 unless the terminal has in and the software uses it.) 
When a is specified, it is sometimes useful to give a delay of the 
form 3.5 to specify a delay per unit to tenths of milliseconds. (Only 
one decimal place is allowed.) 

A T indicates that the padding is mandatory. Absence of a 7’ is not 
shown, if the terminal has xon defined. Padding information is 
advisory and will be used only for cost estimates or when the terminal 
is in raw mode. Mandatory padding will be transmitted regardless of 
the setting of xon. 

A number of escape sequences are provided in the string valued capa¬ 
bilities for easy encoding of characters there. Both \E and \e map to 
an ESCAPE character, A x maps to a control-x for any appropriate x, 
and the sequences \n, \1, \r, \t, \b, \f, and \s give a newline, linefeed, 
return, tab, backspace, formfeed, and space, respectively. Other 
escapes include: \ A for caret ( A ); \\ for backslash (\); \, for comma 
(,); \: for colon (:); and \0 for null. (\0 will actually produce \200, 
which does not terminate a string but behaves as a null character on 
most terminals.) Finally, characters may be given as three octal digits 
after a backslash (e.g.,\123). 

Sometimes individual capabilities must be commented out. To do 
this, put a period before the capability name. For example, see the 
second ind in the example above. Note that capabilities are defined in 
a left-to-right order and, therefore, a prior definition will override a 
later definition. 
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Preparing Descriptions 

The most effective way to prepare a terminal description is by imitat¬ 
ing the description of a similar terminal in terminfo and to build up a 
description gradually, using partial descriptions with v/(C) to check 
that they are correct. Be aware that a very unusual terminal may 
expose deficiencies in the ability of the terminfo file to describe it or 
the inability of vi(C) to work with that terminal. To test a new termi¬ 
nal description, set the environment variable TERMINFO to a path¬ 
name of a directory containing the compiled description you are work¬ 
ing on and programs will look there rather than in / usr/lib/terminfo. 
To get the padding for insert-line correct (if the terminal manufacturer 
did not document it) a severe test is to comment out xon, edit a large 
file at 9600 baud with vj'(C), delete 16 or so lines from the middle of 
the screen, then hit the u key several times quickly. If the display is 
corrupted, more padding is usually needed. A similar test can be used 
for insert-character. 


Section 1-1: Basic Capabilities 

The number of columns on each line for the terminal is given by the 
cols numeric capability. If the terminal has a screen, then the number 
of lines on the screen is given by the lines capability. If the terminal 
can clear its screen, leaving the cursor in the home position, then this 
is given by the clear string capability. If the terminal overstrikes 
(rather than clearing a position when a character is struck over) then it 
should have the os capability. If the terminal is a printing terminal, 
with no soft copy unit, give it both he and os. (os applies to storage 
scope terminals, such as the Tektronix 4010 series, as well as hard¬ 
copy and APL terminals.) If there is a code to move the cursor to the 
left edge of the current row, give this as cr. (Normally this will be 
carnage return, control M.) If there is a code to produce an audible 
signal (such as a bell or a beep), specify it as bel. If the terminal uses 
the xon-xoff flow-control protocol, like most terminals, specify xon. 

If there is a code to move the cursor one position to the left (such as 
backspace), that capability should be given as cubl. Similarly, codes 
to move to the right, up, and down should be given as cutt, cuul, and 
cudl. These local cursor motions should not alter the text they pass 
over; for example, you would not normally use “cufl=\s” because the 
space would erase the character moved over. 

A very important point here is that the local cursor motions encoded in 
terminfo are undefined at the left and top edges of a screen terminal. 
Programs should never attempt to backspace around the left edge, 
unless bw is given, and should never attempt to go up locally off the 
top. In order to scroll text up, a program will go to the bottom left 
comer of the screen and send the ind (index) string. 
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To scroll text down, a program goes to the top left comer of the screen 
and sends the ri (reverse index) string. The strings ind and ri are 
undefined when not on their respective comers of the screen. 

Parameterized versions of the scrolling sequences are indn and rin 
which have the same semantics as ind and ri except that they take one 
parameter, and scroll that many lines. They are also undefined except 
at the appropriate edge of the screen. 

If the terminal wraps around to the beginning of the next line when it 
reaches the right margin, then it should have the am capability. The 
am capability tells whether the cursor sticks at the right edge of the 
screen when text is output, but this does not necessarily apply to a 
cufl from the last column. The only local motion which is defined 
from the left edge is if bw is given, then a cubl from the left edge will 
move to the right edge of the previous row. If bw is not given, the 
effect is undefined. This is useful for drawing a box around the edge 
of the screen, for example. If the terminal has switch selectable 
automatic margins, the terminfo file usually assumes that this is on; 
i.e., am. If the terminal has a command which moves to the first 
column of the next line, that command can be given as nel (newline). 
It does not matter if the command clears the remainder of the current 
line, so if the terminal has no cr and If it may still be possible to craft 
a working nel out of one or both of them. 

These capabilities suffice to describe hardcopy and screen terminals. 
Thus the model 33 teleprinter is described as: 

he, os, xon 
cols#72, 

bel=~G, cr=\r, cudl=\n, ind=\n, 

while the Lear Siegler ADM-3 is described as: 
adm3 I lsi adm3, 

am, bel=~G, clear=~Z, cols#80, cr=~M, cubl=~H, 
cudl=~ J, ind=~J, lines#24. 

Section 1-2: Parameterized Strings 

Cursor addressing and other strings requiring parameters in the termi¬ 
nal are described by a parameterized string capability, with printf(S)- 
like escapes (%x) in it. For example, to address the cursor, the cup 
capability is given, using two parameters: the row and column to 
address to. (Rows and columns are numbered from zero and refer to 
the physical screen visible to the user, not to any unseen memory.) If 
the terminal has memory relative cursor addressing, that can be indi¬ 
cated by mrcup. 

The parameter mechanism uses a stack and special % codes to mani¬ 
pulate it in the manner of a Reverse Polish Notation (postfix) calcula¬ 
tor. Typically a sequence will push one of the parameters onto the 
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stack and then print it in some format. Often more complex opera¬ 
tions are necessary. Binary operations are in postfix form with the 
operands in the usual order. That is, to get x-5 one would use 
%gx%{5}%-. 

The % encodings have the following meanings: 

%% outputs *%’ 

% t [:]/?«££] [width[.precision] ] [doxXs] 

as in printf, flags are [-+#] and space 
%c print pop() gives %c 

%p[l-9] push i^ 1 parm 

%P[a-z] set variable [a-z] to pop() 

%g[a-z] get variable [a-z] and push it 

%’S push char constant c 

%[nn) push decimal constant nn 

%\ push strlen(popO) 

%+ %- %* %/ %m 

arithmetic (%m is mod): push(pop() op pop()) 

%& %\ %' bit operations: push(pop() op pop()) 

%= %> %< logical operations: push(pop() op pop()) 

%A %0 logical operations: and, or 

%! %~ unary operations: push(op pop()) 

%i (for ANSI terminals) 

add 1 to first parm, if one parm present, 

or first two parms, if more than one parm present 

%? expr %t thenpart %e elsepart %; 

if-then-else, %e elsepart is optional; 
else-if’s are possible ala Algol 68: 

%? Cj %t bj %e c %t b %e c 3 %t b g %e c 4 %t b %e b %; 
Cj are conditions, b. are bodies. 

If the flag is used with “%[doxXs]”, then a colon (:) must be 
placed between the “%” and the to differentiate the flag from the 
binary operator, .e.g., “%:-16.16s”. 

Consider the Hewlett-Packard 2645, which, to get to row 3 and 
column 12, needs to be sent \E&al2c03Y padded for 6 milliseconds. 
Note that the order of the rows and columns is inverted here, and that 
the row and column are zero-padded as two digits. Thus its cup capa¬ 
bility is ‘ ‘cup=\E&a%p2%2.2dc%p 1 %2.2dY$<6>’ ’. 

The Micro-Term ACT-IV needs the current row and column sent pre¬ 
ceded by a a T, with the row and column simply encoded in binary, 
“cup= A T%pl%c%p2%c”. Terminals which use “%c” need to be 
able to backspace the cursor (cubl), and to move the cursor up one 
line on the screen (cuul). This is necessary because it is not always 
safe to transmit \n, ~D, and \r, as the system may change or discard 
them. (The library routines dealing with terminfo set tty modes so that 
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tabs are never expanded, so \t is safe to send. This turns out to be 
essential for the Ann Arbor 4080.) 

A final example is the LSI ADM-3a, which uses row and column offset 
by a blank character, thus 

“cup=NE=%pl%’\s’%+%c%p2%’V%+%c”. After sending “NE=”, 
this pushes the first parameter, pushes the ASCII value for a space (S), 
adds them (pushing the sum on the stack in place of the two previous 
values), and outputs that value as a character. Then the same is done 
for the second parameter. More complex arithmetic is possible using 
the stack. 


Section 1-3: Cursor Motions 

If the terminal has a fast way to home the cursor (to very upper left 
comer of screen) then this can be given as home; similarly a fast way 
of getting to the lower left-hand comer can be given as 11; this may 
involve going up with cuul from the home position, but a program 
should never do this itself (unless 11 does) because it can make no 
assumption about the effect of moving up from the home position. 
Note that the home position is the same as addressing to (0,0): to the 
top left comer of the screen, not of memory. (Thus, the \EH sequence 
on Hewlett-Packard terminals cannot be used for home without losing 
some of the other features on the terminal.) 

If the terminal has row or column absolute-cursor addressing, these 
can be given as single parameter capabilities hpa (horizontal position 
absolute) and vpa (vertical position absolute). Sometimes these are 
shorter than the more general two-parameter sequence (as with the 
Hewlett-Packard 2645) and can be used in preference to cup. If there 
are parameterized local motions (e.g., move n spaces to the right) 
these can be given as cud, cub, cuf, and cuu with a single parameter 
indicating how many spaces to move. These are primarily useful if 
the terminal does not have cup, such as the Tektronix 4025. 


Section 1-4: Area Clears 

If the terminal can clear from the current position to the end of the 
line, leaving the cursor where it is, this should be given as el. If the 
terminal can clear from the beginning of the line to the current posi¬ 
tion inclusive, leaving the cursor where it is, this should be given as 
ell. If the terminal can clear from the current position to the end of 
the display, then this should be given as ed. ed is only defined from 
the first column of a line. (Thus, it can be simulated by a request to 
delete a large number of lines, if a true ed is not available.) 
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Section 1-5: Insert/Delete Line 

If the terminal can open a new blank line before the line where the 
cursor is, this should be given as ill; this is done only from the first 
position of a line. The cursor must then appear on the newly blank 
line. If the terminal can delete the line which the cursor is on, then 
this should be given as dll; this is done only from the first position on 
the line to be deleted. Versions of ill and dll which take a single 
parameter and insert or delete that many lines can be given as il and 
dl. 

If the terminal has a settable destructive scrolling region (like the 
VT100) the command to set this can be described with the csr capa¬ 
bility, which takes two parameters: the top and bottom lines of the 
scrolling region. The cursor position is, alas, undefined after using 
this command. It is possible to get the effect of insert or delete line 
using this command — the sc and rc (save and restore cursor) com¬ 
mands are also useful. Inserting lines at the top or bottom of the 
screen can also be done using ri or ind on many terminals without a 
true insert/delete line, and is often faster even on terminals with those 
features. 

To determine whether a terminal has destructive scrolling regions or 
non-destructive scrolling regions, create a scrolling region in the mid¬ 
dle of the screen, place data on the bottom line of the scrolling region, 
move the cursor to the top line of the scrolling region, and do a reverse 
index (ri) followed by a delete line (dll) or index (ind). If the data 
that was originally on the bottom line of the scrolling region was 
restored into the scrolling region by the dll or ind, then the terminal 
has non-destructive scrolling regions. Otherwise, it has destructive 
scrolling regions. Do not specify csr if the terminal has non¬ 
destructive scrolling regions, unless ind, ri, indn, rin, dl, and dll all 
simulate destructive scrolling. 

If the terminal has the ability to define a window as part of memory, 
which all commands affect, it should be given as the parameterized 
string wind. The four parameters are the starting and ending lines in 
memory and the starting and ending columns in memory, in that order. 

If the terminal can retain display memory above, then the da capabil¬ 
ity should be given; if display memory can be retained below, then db 
should be given. These indicate that deleting a line or scrolling a full 
screen may bring non-blank lines up from below or that scrolling back 
with ri may bring down non-blank lines. 


Section 1-6: Insert/Delete Character 

There are two basic kinds of intelligent terminals with respect to 
insert/delete character operations which can be described using ter- 
minfo. The most common insert/delete character operations affect only 
the characters on the current line and shift characters off the end of the 
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line rigidly. Other terminals, such as the Concept 100 and the Perkin 
Elmer Owl, make a distinction between typed and untyped blanks on 
the screen, shifting upon an insert or delete only to an untyped blank 
on the screen which is either eliminated, or expanded to two untyped 
blanks. You can determine the kind of terminal you have by clearing 
the screen and then typing text separated by cursor motions. Type 
“abc def” using local cursor motions (not spaces) between the abc 
and the def. Then position the cursor before the abc and put the termi¬ 
nal in insert mode. If typing characters causes the rest of the line to 
shift rigidly and characters to fall off the end, then your terminal does 
not distinguish between blanks and untyped positions. If the abc 
shifts over to the def which then move together around the end of the 
current line and onto the next as you insert, you have the second type 
of terminal, and should give the capability in, which stands for “insert 
null”. While these are two logically separate attributes (one line 
versus multiline insert mode, and special treatment of untyped spaces) 
no terminals whose insert mode cannot be described with the single 
attribute have been seen. 

terminfo can describe both terminals which have an insert mode and 
terminals which send a simple sequence to open a blank position on 
the current line. Give as smir the sequence to get into insert mode. 
Give as rmir the sequence to leave insert mode. Now give as ichl 
any sequence needed to be sent just before sending the character to be 
inserted. Most terminals with a true insert mode will not give ichl; 
terminals which send a sequence to open a screen position should give 
it here. (If your terminal has both, insert mode is usually preferable to 
ichl. Do not give both unless the terminal actually requires both to be 
used in combination.) If post-insert padding is needed, give this as a 
number of milliseconds padding in ip (a string option). Any other 
sequence which may need to be sent after an insert of a single charac¬ 
ter may also be given in ip. If your terminal needs both to be placed 
into an ‘insert mode’ and a special code to precede each inserted char¬ 
acter, then both smir/rmir and ichl can be given, and both will be 
used. The ich capability, with one parameter, n, will insert n blanks. 

If padding is necessary between characters typed while not in insert 
mode, give this as a number of milliseconds padding in rmp. 

It is occasionally necessary to move around while in insert mode to 
delete characters on the same line (e.g., if there is a tab after the inser¬ 
tion position). If your terminal allows motion while in insert mode 
you can give the capability mir to speed up inserting in this case. 
Omitting mir will affect only speed. Some terminals (notably 
Datamedia’s) must not have mir because of the way their insert mode 
works. 

Finally, you can specify dchl to delete a single character, dch with 
one parameter, n, to delete n characters, and delete mode by giving 
smdc and rmdc to enter and exit delete mode (any mode the terminal 
needs to be placed in for dchl to work). 
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A command to erase n characters (equivalent to outputting n blanks 
without moving the cursor) can be given as ech with one parameter. 


Section 1-7: Highlighting, Underlining, and Visible Bells 

Your terminal may have one or more kinds of display attributes that 
allow you to highlight selected characters when they appear on the 
screen. The following display modes (shown with the names by which 
they are set) may be available: a blinking screen (blink), bold or 
extra-bright characters (bold), dim or half-bright characters (dim), 
blanking or invisible text (invis), protected text (prot), a reverse- 
video screen (rev), and an alternate character set (smacs to enter this 
mode and rmacs to exit it). (If a command is necessary before you 
can enter alternate character set mode, give the sequence in enacs or 
“enable altemate-character-set’ ’ mode.) Turning on any of these 
modes singly may or may not turn off other modes. 

If you set any display attributes for highlighting, you will also want to 
provide the capability for turning them off. To do so, set sgrO. 

You should choose one display method as standout mode [see 
curses{ S)] and use it to highlight error messages and other kinds of 
text to which you want to draw attention. Choose a form of display 
that provides strong contrast but that is easy on the eyes. (We recom¬ 
mend reverse-video plus half-bright or reverse-video alone.) The 
sequences to enter and exit standout mode are given as smso and 
rmso, respectively. If the code to change into or out of standout mode 
leaves one or even two blank spaces on the screen, as the TVI 912 and 
Teleray 1061 do, then xmc should be given to tell how many spaces 
are left. 

Codes to begin underlining and end underlining can be given as smul 
and rmul , respectively. If the terminal has a code to underline the 
current character and move the cursor one space to the right, such as 
the Micro-Term MIME, this can be given as uc. 

For historical reasons, some programs interpret rmso, rmul to mean 
"turn off all attributes," not just standout and underline, respectively. 

If there is a sequence to set arbitrary combinations of modes, this 
should be given as sgr (set attributes), taking nine parameters. Each 
parameter is either 0 or non-zero, as the corresponding attribute is on 
or off. The nine parameters are, in order: standout, underline, reverse, 
blink, dim, bold, blank, protect, alternate character set. Not all modes 
need to be supported by sgr; only those for which corresponding 
separate attribute commands exist should be supported. (See the 
example at the end of this section.) 

Terminals with the “magic cookie’’ glitch (xmc) deposit special 
“cookies’’ when they receive mode-setting sequences, which affect 
the display algorithm rather than having extra bits for each character. 
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Some terminals, such as the Hewlett-Packard 2621, automatically 
leave standout mode when they move to a new line or the cursor is 
addressed. Programs using standout mode should exit standout mode 
before moving the cursor or sending a newline, unless the msgr capa¬ 
bility, asserting that it is safe to move in standout mode, is present. 

If the terminal has a way of flashing the screen to indicate an error 
quietly (a bell replacement), then this can be given as flash; it must 
not move the cursor. A good flash can be done by changing the screen 
into reverse video, pad for 200 ms, then return the screen to normal 
video. 

If the cursor needs to be made more visible than normal when it is not 
on the bottom line (to make, for example, a non-blinking underline 
into an easier to find block or blinking underline) give this sequence as 
cvvis. The boolean chts should also be given. If there is a way to 
make the cursor completely invisible, give that as civis. The capabil¬ 
ity cnorm should be given which undoes the effects of either of these 
modes. 

If the terminal needs to be in a special mode when running a program 
that uses these capabilities, the codes to enter and exit this mode can 
be given as smcup and rmcup. This arises, for example, from termi¬ 
nals, such as the Concept , with more than one page of memory. If the 
terminal has only memory relative cursor addressing and not screen 
relative cursor addressing, a one screen-sized window must be fixed 
into the terminal for cursor addressing to work properly. This is also 
used for the Tektronix 4025, where smcup sets the command character 
to be the one used by terminfo. If the smcup sequence will not 
restore the screen after a rmcup sequence is output (to the state prior 
to outputting rmcup), specify nrrmc. 

If your terminal generates underlined characters by using the under¬ 
line character (with no special codes needed) even though it does not 
otherwise overstrike characters, then you should give the capability 
ul. For terminals where a character overstriking another leaves both 
characters on the screen, give the capability os. If overstrikes are 
erasable with a blank, then this should be indicated by giving eo. 

Example of highlighting: assume that the terminal under question 
needs the following escape sequences to turn on various modes. 


tparm 

parameter 


attribute 


escape sequence 


Pi 

p2 

p3 


none 

standout 

underline 

reverse 


\E[0m 

\E[0;4;7m 

\E[0;3m 

\E[0;4m 
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p4 

blink 

NE[0;5m 

p5 

dim 

\E[0;7m 

p6 

bold 

NE[0;3;4m 

P7 

invis 

\E[0;8m 

p8 

protect 

not available 

p9 

altcharset 

A 0 (off) A N(on) 


Note that each escape sequence requires a 0 to turn off other modes 
before turning on its own mode. Also note that, as suggested above, 
standout is set up to be the combination of reverse and dim. Also, 
because this terminal has no bold mode, bold is set up as the combina¬ 
tion of reverse and underline. In addition, to allow combinations, 
such as underline+blink , the sequence to use would be \E[0;3;5m. 
The terminal doesn’t have protect mode, either, but that cannot be 
simulated in any way, so p8 is ignored. The altcharset mode is 
different in that it is either a O or A N, depending on whether it is off or 
on. If all modes were to be turned on, the sequence would be 
\E[0;3;4;5;7;8m A N. 


Now look at when different sequences are output. For example, ;3 is 
output when either p2 or p6 is true, that is, if either underline or bold 
modes are turned on. Writing out the above sequences, along with 
their dependencies, gives the following: 


sequence 

\E[0 

;3 

;4 

;5 

;7 

;8 

m 

a N or A 0 


when to output 

always 
if p2 or p6 
if pi or p3 or p6 
if p4 

if pi or p5 
if p7 
always 

if p9 a N, else A 0 


terminfo translation 

\E[0 

%?%p2%p6%l%t;3%; 

%?%pl%p3%l%p6%l%t;4%; 

%?%p4%t;5%; 

%?%pl%p5%l%t;7%; 

%?%p7%t;8%; 

m 

%?%p9%t A N%e A 0%; 


Putting this all together into the sgr sequence gives: 


sgr=\E[0%?%p2%p6%l%t;3%;%?%pl%p3%l%p6%l%t;4%;%?%p5%t;5%; 

%?%pl%p5%l%t;7%;%?%p7%t;8%;m%?%p9%t A N%e A 0%;, 


Section 1-8: Keypad 

If the terminal has a keypad that transmits codes when the keys are 
pressed, this information can be given. Note that it is not possible to 
handle terminals where the keypad only works in local (this applies, 
for example, to the unshifted Hewlett-Packard 2621 keys). If the 
keypad can be set to transmit or not transmit, give these codes as 
smkx and rmkx. Otherwise the keypad is assumed to transmit. 

The codes sent by the left arrow, right arrow, up arrow, down arrow, 
and home keys can be given as kcubl, kcufl, kcuul, kcudl, and 
khome respectively. If there are function keys such as fO, fl,..., f63, 
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the codes they send can be given as kfO, kfl,kf63. If the first 11 
keys have labels other than the default fO through flO, the labels can 
be given as lfO, lfl, lflO. The codes transmitted by certain other 
special keys can be given: kll (home down), kbs (backspace), ktbc 
(clear all tabs), kctab (clear the tab stop in this column), kclr (clear 
screen or erase key), kdchl (delete character), kdll (delete line), 
krmir (exit insert mode), kel (clear to end of line), ked (clear to end 
of screen), kichl (insert character or enter insert mode), kill (insert 
line), knp (next page), kpp (previous page), kind (scroll 
forward/down), kri (scroll backward/up), khts (set a tab stop in this 
column). In addition, if the keypad has a 3 by 3 array of keys includ¬ 
ing the four arrow keys, the other five keys can be given as kal, ka3, 
kb2, kcl, and kc3. These keys are useful when the effects of a 3 by 3 
directional pad are needed. Further keys are defined above in the 
capabilities list. 

Strings to program function keys can be given as pfkey, pfloc, and 
pfx. A string to program their soft-screen labels can be given as pin. 
Each of these strings takes two parameters: the function key number 
to program (from 0 to 10) and the string to program it with. Function 
key numbers out of this range may program undefined keys in a 
terminal-dependent manner. The difference between the capabilities 
is that pfkey causes pressing the given key to be the same as the user 
typing the given string; pfloc causes the string to be executed by the 
terminal in local mode; and pfx causes the string to be transmitted to 
the computer. The capabilities nlab, lw, and lh define how many soft 
labels there are and their width and height. If there are commands to 
turn the labels on and off, give them in smln and rmln. smln is nor¬ 
mally output after one or more pin sequences to make sure that the 
change becomes visible. 


Section 1-9: Tabs and Initialization 

If the terminal has hardware tabs, the command to advance to the next 
tab stop can be given as ht (usually control I). A “backtab” command 
which moves leftward to the next tab stop can be given as cbt. By 
convention, if the teletype modes indicate that tabs are being 
expanded by the computer rather than being sent to the terminal, pro¬ 
grams should not use ht or cbt even if they are present, since the user 
may not have the tab stops properly set. If the terminal has hardware 
tabs which are initially set every n spaces when the terminal is 
powered up, the numeric parameter it is given, showing the number of 
spaces the tabs are set to. This is normally used by tput init [see 
tput(C)\ to determine whether to set the mode for hardware tab expan¬ 
sion and whether to set the tab stops. If the terminal has tab stops that 
can be saved in nonvolatile memory, the terminfo description can 
assume that they are properly set. If there are commands to set and 
clear tab stops, they can be given as tbc (clear all tab stops) and hts 
(set a tab stop in the current column of every row). 
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Other capabilities include: isl, is2, and is3, initialization strings for 
the terminal; iprog, the path name of a program to be run to initialize 
the terminal; and if, the name of a file containing long initialization 
strings. These strings are expected to set the terminal into modes con¬ 
sistent with the rest of the terminfo description. They must be sent to 
the terminal each time the user logs in and be output in the following 
order: run the program iprog; output isl; output is2; set the margins 
using mgc, smgl, and smgr; set the tabs using tbc and hts; print the 
file if; and finally output is3. This is usually done using the init option 
of tput(C)\ see profile(F). 

Most initialization is done with is2. Special terminal modes can be 
set up without duplicating strings by putting the common sequences in 
is2 and special cases in isl and is3. Sequences that do a harder reset 
from a totally unknown state can be given as rsl, rs2, rf, and rs3, 
analogous to isl, is2, is3, and if. (The method using files, if and rf, is 
used for a few terminals, from /usrllib/tabsetl *; however, the recom¬ 
mended method is to use the initialization and reset strings.) These 
strings are output by tput reset, which is used when the terminal gets 
into a wedged state. Commands are normally placed in rsl, rs2, rs3, 
and rf only if they produce annoying effects on the screen and are not 
necessary when logging in. For example, the command to set a termi¬ 
nal into 80-column mode would normally be part of is2, but on some 
terminals it causes an annoying glitch on the screen and is not nor¬ 
mally needed since the terminal is usually already in 80-column 
mode. 

If a more complex sequence is needed to set the tabs than can be 
described by using tbc and hts, the sequence can be placed in is2 or if. 

Any margin can be cleared with mgc. (For instructions on how to 
specify commands to set and clear margins, see “Margins” below 
under “PRINTER CAPABILITIES.”) 


Section 1-10: Delays 

Certain capabilities control padding in the tty(J) driver. These are pri¬ 
marily needed by hard-copy terminals, and are used by tput init to set 
tty modes appropriately. Delays embedded in the capabilities cr, ind, 
cubl, IT, and tab can be used to set the appropriate delay bits to be set 
in the tty driver. If pb (padding baud rate) is given, these values can 
be ignored at baud rates below the value of pb. 


Section 1-11: Status Lines 

If the terminal has an extra “status line” that is not normally used by 
software, this fact can be indicated. If the status line is viewed as an 
extra line below the bottom line, into which one can cursor address 
normally (such as the Heathkit hl9’s 25th line, or the 24th line of a 
VT100 which is set to a 23-line scrolling region), the capability hs 
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should be given. Special strings that go to a given column of the 
status line and return from the status line can be given as tsl and fsl. 
(fsl must leave the cursor position in the same place it was before tsl. 
If necessary, the sc and rc strings can be included in tsl and fsl to get 
this effect.) The capability tsl takes one parameter, which is the 
column number of the status line the cursor is to be moved to. 

If escape sequences and other special commands, such as tab, work 
while in the status line, the flag eslok can be given. A string which 
turns off the status line (or otherwise erases its contents) should be 
given as dsl. If the terminal has commands to save and restore the 
position of the cursor, give them as sc and rc. The status line is nor¬ 
mally assumed to be the same width as the rest of the screen, e.g., 
cols. If the status line is a different width (possibly because the termi¬ 
nal does not allow an entire line to be loaded) the width, in columns, 
can be indicated with the numeric parameter wsl. 


Section 1-12: Line Graphics 

If the terminal has a line drawing alternate character set, the mapping 
of glyph to character would be given in acsc. The definition of this 
string is based on the alternate character set used in the DEC VT100 
terminal, extended slightly with some characters from the AT&T 


4410vl terminal. 


glyph name 


vtl00+ 

character 


arrow pointing right 
arrow pointing left 
arrow pointing down 
solid square block 
lantern symbol 
arrow pointing up 
diamond 

checker board (stipple) 
degree symbol 
plus/minus 
board of squares 
lower right comer 
upper right comer 
upper left comer 
lower left comer 
plus 

scan line 1 
horizontal line 
scan line 9 


+ 


a 

f 

g 

h 

j 

k 

1 

m 

n 

o 


0 

I 


q 


s 

t 


left tee ([) 
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right tee (-J) 
bottom tee Q) 
top tee (J) 
vertical line 
bullet 


The best way to describe a new terminal’s line graphics set is to add a 
third column to the above table with the characters for the new termi¬ 
nal that produce the appropriate glyph when the terminal is in the 
alternate character set mode. For example, 


glyph name 

upper left comer 
lower left comer 
upper right comer 
lower right comer 
horizontal line 
vertical line 


vtl00+ 

character 

1 

m 

k 

j 

q 

x 


new tty 
character 

R 

F 

T 

G 


Now write down the characters left to right as in 
“acsc=lRmFkTjGq\x.”. 6 

In addition, terminfo allows you to define multiple character sets See 
Section 2-5 for details. 


Section 1-13: Color Manipulation 

There are two methods of color manipulation: the HP method and the 
Tektronix method. Most existing color terminals belong to one of 
these two classes. 

The Tektronix method uses a set of N predefined colors (usually 8) 
from which a user can select current" foreground and background 
colors. Thus the terminal can support up to N colors mixed into N*N 
color-pairs to be displayed on the screen at the same time. 

The HP method restricts the user from defining the foreground 
independently of the background, or vice-versa. Instead, the user must 
define an entire color-pair at once. Up to M color-pairs, made from 
2*M different colors, can be defined this way. 


The numeric variables colors and pairs define the number of colors 
and color-pairs that can be displayed on the screen at the same time. 
If a terminal can change the definition of a color (as can, for example, 
the Tektronix 4100 and 4200 series terminals), this should be specified 
with ccc (can change color). To change the definition of a color (Tek¬ 
tronix method), use initc (initialize color). It requires four arguments - 
color number (ranging from 0 to colors-1) and three RGB (red, green, 
and blue) values (ranging from 0 to 1,000). 
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Tektronix 4100 series terminals use a type of color notation called 
HLS (Hue Lightness Saturation) instead of RGB color notation. For 
such terminals one must define a boolean variable his. The last three 
arguments to the initc string would then be HLS values: H, ranging 
from 0 to 360; and L and S, ranging from 0 to 100. 

If a terminal can change the definitions of colors, but uses a color 
notation different from RGB and HLS, a mapping to either RGB or 
HLS must be developed. 

To set current foreground or background to a given color, use setff (set 
foreground) and setb (set background). They require one parameter: 
the number of the color. To initialize a color-pair (HP method), use 
initp (initialize pair). It requires seven parameters: the number of a 
color-pair (range = 0 to pairs-1), and six RGB values: three for the 
foreground followed by three for the background. ^ (Each of these 
groups of three should be in the order RGB.) When initc or initp are 
used, RGB or HLS arguments should be in the order "red, green, blue" 
or "hue, lightness, saturation"), respectively. To make a color-pair 
current, use scp (set color-pair). It takes one parameter, the number of 
a color-pair. 

Some terminals (for example, most color terminal emulators for PCs) 
erase areas of the screen with current background color. In such cases, 
bee (background color erase) should be defined. The variable op (ori¬ 
ginal pair) contains a sequence for setting the foreground and the 
background colors to what they were at the terminal start-up time. 
Similarly, oc (original colors) contains a control sequence for setting 
all colors (for the Tektronix method) or color-pairs (for the HP 
method) to the values they had at the terminal start-up time. 

Some color terminals substitute color for video attributes. Such video 
attributes should not be combined with colors. Information about 
these video attributes should be packed into the nev (no color video) 
variable. There is a one-to-one correspondence between the nine least 
significant bits of that variable and the video attributes. The following 
table depicts this correspondence. 


Attribute 


NCV Bit 
Number 


A STANDOUT 

AJJNDERLINE 

A_REVERSE 

A_BLINK 

A_DIM 

A_BOLD 

AJNVIS 

A.PROTECT 


0 


2 

3 

4 

5 

6 
7 
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A_ALTCHARSET 8 

When a particular video attribute should not be used with colors, the 
corresponding ncv bit should be set to 1; otherwise it should be set to 
zero. For example, if the terminal uses colors to simulate reverse 
video and bold, bits 2 and 5 should be set to 1. The resulting values 
for ncv will be 22. 


Section 1-14: Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then 
this can be given as pad. Only the first character of the pad string is 
used. If the terminal does not have a pad character, specify npc. 

If the terminal can move up or down half a line, this can be indicated 
with hu (half-line up) and hd (half-line down). This is primarily use¬ 
ful for superscripts and subscripts on hardcopy terminals. If a hard¬ 
copy terminal can eject to the next page (form feed), give this as flf 
(usually control L). 

If there is a command to repeat a given character a given number of 
times (to save time transmitting a large number of identical charac¬ 
ters) this can be indicated with the parameterized string rep. The first 
parameter is the character to be repeated and the second is the number 
of times to repeat it. Thus, tparm(repeat_char, ’x’, 10) is the same as 
xxxxxxxxxx. 

If the terminal has a settable command character, such as the Tek¬ 
tronix 4025, this can be indicated with cmdch. A prototype command 
character is chosen which is used in all capabilities. This character is 
given in the cmdch capability to identify it. The following conven¬ 
tion is supported on some UNIX systems: If the environment variable 
CC exists, all occurrences of the prototype character are replaced with 
the character in CC. 

Terminal descriptions that do not represent a specific kind of known 
terminal, such as switch, dialup, patch, and network, should include 
the gn (generic) capability so that programs can complain that they do 
not know how to talk to the terminal. (This capability does not apply 
to virtual terminal descriptions for which the escape sequences are 
known.) If the terminal is one of those supported by the UNIX system 
virtual terminal protocol, the terminal number can be given as vt. A 
line-turn-around sequence to be transmitted before doing reads should 
be specified in rfi. 

If the terminal uses xon/xoff handshaking for flow control, give xon. 
Padding information should still be included so that routines can make 
better decisions about costs, but actual pad characters will not be 
transmitted. Sequences to turn on and off xon/xoff handshaking may 
be given in smxon and rmxon. If the characters used for handshaking 
are not *S and a Q, they may be specified with xonc and xoffc. 
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If the terminal has a “meta key” which acts as a shift key, setting the 
8th bit of any character transmitted, this fact can be indicated with 
km. Otherwise, software will assume that the 8th bit is parity and it 
will usually be cleared. If strings exist to turn this “meta mode” on 
and off, they can be given as smm and rmm. 

If the terminal has more lines of memory than will fit on the screen at 
once, the number of lines of memory can be indicated with 1m. A 
value of lm#0 indicates that the number of lines is not fixed, but that 
there is still more memory than fits on the screen. 

Media copy strings which control an auxiliary printer connected to the 
terminal can be given as mcO: print the contents of the screen, mc4: 
turn off the printer, and mc5: turn on the printer. When the printer is 
on, all text sent to the terminal will be sent to the printer. A variation, 
mc5p, takes one parameter, and leaves the printer on for as many 
characters as the value of the parameter, then turns the printer off. The 
parameter should not exceed 255. If the text is not displayed on the 
terminal screen when the printer is on, specify mc5i (silent printer). 
All text, including mc4, is transparently passed to the printer while an 
mc5p is in effect. 


Section 1-15: Special Cases 

The working model used by terminfo fits most terminals reasonably 
well. However, some terminals do not completely match that model, 
requiring special support by terminfo. These are not to be construed 
as deficiencies in the terminals; they are just differences between the 
working model and the actual hardware. They may be unusual dev¬ 
ices or, for some reason, do not have all the features of the terminfo 
model implemented. 

Terminals which can not display tilde (") characters, such as certain 
Hazeltine terminals, should indicate hz. 

Terminals which ignore a linefeed immediately after an am wrap, 
such as the Concept 100, should indicate xenl. Those terminals whose 
cursor remains on the right-most column until another character has 
been received, rather than wrapping immediately upon receiving the 
right-most character, such as the VT100, should also indicate xenl. 

If el is required to get rid of standout (instead of writing normal text 
on top of it), xhp should be given. 

Those Teleray terminals whose tabs turn all characters moved over to 
blanks, should indicate xt (destructive tabs). This capability is also 
taken to mean that it is not possible to position the cursor on top of a 
“magic cookie” therefore, to erase standout mode, it is instead neces¬ 
sary to use delete and insert line. 
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Those Beehive Superbee terminals which do not transmit the escape 
or control-C characters, should specify xsb, indicating that the fl key 
is to be used for escape and the f2 key for control-C. 


Section 1-16: Similar Terminals 

If there are two very similar terminals, one can be defined as being 
just like the other with certain exceptions. The string capability use 
can be given with the name of the similar terminal. The capabilities 
given before use override those in the terminal type invoked by use. 
A capability can be canceled by placing xx@ to the left of the capabil¬ 
ity definition, where xx is the capability. For example, the entry 

att4424-2|Teletype 4424 in display function group ii, 
rev@, sgr@, smul@, use=att4424, 

defines an AT&T 4424 terminal that does not have the rev, sgr, and 
smul capabilities, and hence cannot do highlighting. This is useful for 
different modes for a terminal, or for different user preferences. More 
than one use capability may be given. 


PART 2: PRINTER CAPABILITIES 

The terminfo database allows you to define capabilities of printers as 
well as terminals. To find out what capabilities are available for 
printers as well as for terminals, see the two lists under "TERMINAL 
CAPABILITIES" that list capabilities by variable and by capability 
name. 


Section 2-1: Rounding Values 

Because parameterized string capabilities work only with integer 
values, we recommend that terminfo designers create strings that 
expect numeric values that have been rounded. Application designers 
should note this and should always round values to the nearest integer 
before using them with a parameterized string capability. 


Section 2-2: Printer Resolution 

A printer’s resolution is defined to be the smallest spacing of charac¬ 
ters it can achieve. In general printers have independent resolution 
horizontally and vertically. Thus the vertical resolution of a printer 
can be determined by measuring the smallest achievable distance 
between consecutive printing baselines, while the horizontal resolu¬ 
tion can be determined by measuring the smallest achievable distance 
between the left-most edges of consecutive printed, identical, charac¬ 
ters. 


March 15, 1989 


TERMINFO-42 





TERMINFO (M) 


TERMINFO (M) 


All printers are assumed to be capable of printing with a uniform hor¬ 
izontal and vertical resolution. The view of printing that the terminfo 
currently presents is one of printing inside a uniform matrix: All char¬ 
acters are printed at fixed positions relative to each “cell” in the 
matrix; furthermore, each cell has the same size given by the smallest 
horizontal and vertical step sizes dictated by the resolution. (The cell 
size can be changed as will be seen later.) 

Many printers are capable of “proportional printing,” where the hor¬ 
izontal spacing depends on the size of the character last printed. The 
terminfo does not make use of this capability, although it does provide 
enough capability definitions to allow an application to simulate pro¬ 
portional printing. 

A printer must not only be able to print characters as close together as 
the horizontal and vertical resolutions suggest, but also of “moving” 
to a position an integral multiple of the smallest distance away from a 
previous position. Thus printed characters can be spaced apart a dis¬ 
tance that is an integral multiple of the smallest distance, up to the 
length or width of a single page. 

Some printers can have different resolutions depending on different 
“modes.” In “normal mode,” the existing terminfo capabilities are 
assumed to work on columns and lines, just like a video terminal. 
Thus the old lines capability would give the length of a page in lines, 
and the cols capability would give the width of a page in columns. In 
“micro mode,” many terminfo capabilities work on increments of 
lines and columns. With some printers the micro mode may be con¬ 
comitant with normal mode, so that all the capabilities work at the 
same time. 


Section 2-3: Specifying Printer Resolution 

The printing resolution of a printer is given in several ways. Each 
specifies the resolution as the number of smallest steps per distance: 

Specification of Printer Resolution 
Characteristic Number of Smallest Steps 

orhi Steps per inch horizontally 

orvi Steps per inch vertically 

ore Steps per column 

orl Steps per line 

When printing in normal mode, each character printed causes move¬ 
ment to the next column, except in special cases described later; the 
distance moved is the same as the per-column resolution. Some 
printers cause an automatic movement to the next line when a charac¬ 
ter is printed in the rightmost position; the distance moved vertically 
is the same as the per-line resolution. When printing in micro mode, 
these distances can be different, and may be zero for some printers. 
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Specification of Printer Resolution 
Automatic Motion after Printing 

Normal Mode: 

ore Steps moved horizontally 

orl Steps moved vertically 

Micro Mode : 

mes Steps moved horizontally 

mis Steps moved vertically 

Some printers are capable of printing wide characters. The distance 
moved when a wide character is printed in normal mode may be 
different from when a regular width character is printed. The distance 
moved when a wide character is printed in micro mode may also be 
different from when a regular character is printed in micro mode, but 
the differences are assumed to be related: If the distance moved for a 
regular character is the same whether in normal mode or micro mode 
(mcs=orc), then the distance moved for a wide character is also the 
same whether in normal mode or micro mode. This doesn’t mean the 
normal character distance is necessarily the same as the wide charac¬ 
ter distance, just that the distances don’t change with a change in nor¬ 
mal to micro mode. However, if the distance moved for a regular 
character is different in micro mode from the distance moved in nor¬ 
mal mode (mcscorc), the micro mode distance is assumed to be the 
same for a wide character printed in micro mode, as the table below 
shows. 


Specification of Printer Resolution 
Automatic Motion after Printing Wide Character 

Normal Mode or Micro Mode (mes = ore): 

widcs Steps moved horizontally 

Micro Mode (mes < ore): 

mcs Steps moved horizontally 

There may be control sequences to change the number of columns per 
inch (the character pitch) and to change the number of lines per inch 
(the line pitch). If these are used, the resolution of the printer changes, 
but the type of change depends on the printer: 

Specification of Printer Resolution 
_ Changing the Character/Line Pitches 

cpi Change character pitch 

cpix If set, cpi changes orhi, otherwise changes ore 
lpi Change line pitch 

lpix If set, lpi changes orvi, otherwise changes orl 

chr Change steps per column 
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cvr Change steps per line 

The cpi and lpi string capabilities are each used with a single argu¬ 
ment, the pitch in columns (or characters) and lines per inch, respec¬ 
tively. The chr and cvr string capabilities are each used with a single 
argument, the number of steps per column and line, respectively. 

Using any of the control sequences in these strings will imply a 
change in some of the values of ore, orhi, orl, and orvi. Also, the dis¬ 
tance moved when a wide character is printed, widcs, changes in rela¬ 
tion to ore. The distance moved when a character is printed in micro 
mode, mes, changes similarly, with one exception: if the distance is 0 
or 1, then no change is assumed (see item marked with t in the follow¬ 
ing table). 

Programs that use cpi, lpi, chr, or cvr should recalculate the printer 
resolution (and should recalculate other values — see “Section 2-7: 
Effect of Changing Printing Resolution”). 


Specification of Printer Resolution 
Effects of Changing the Character/Line Pitches 
Before After 



Using cpi with cpix set: 

orhi 5 orhi=orc -V cpi 

ore 5 ore 


Using lpi with lpix clear: 
orvi 5 

orl’ 

Using lpi with lpix set: 

orvi 5 

orl 5 


orvi 

orl= 


orvi 

Vlpi 


or\i=orlV i pi 
orl 


Using chr: 

orhi 5 orhi 

ore 5 V chr 


Using cvr: 

orvi 5 orvi 

Orl 5 V cvr 


Using cpi or chr: 
widcs 5 

mes 5 1 


widcs=widcs' 


mcs=mcs 


ore 

ore' 


ore 

ore' 
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V cpi> Vipi 9 V c hr > and V cw are the arguments used with cpi, lpi, chr, 
ana cvr respectively. The t mark indicates the old value. 


Section 2-4: Capabilities that Cause Movement 

In the following descriptions, “movement” refers to the motion of the 
current position.” With video terminals this would be the cursor; 
with some printers this is the carriage position. Other printers have 
different equivalents. In general, the current position is where a char¬ 
acter would be displayed if printed. 

terminfo has string capabilities for control sequences that cause move- 
ment a number of full columns or lines. It also has equivalent string 
capabilities for control sequences that cause movement a number of 
smallest steps. 


String Capabilities for M otion 

mcubl Move 1 step left 

mcufl Move 1 step right 

mcuul Move 1 step up 

mcudl Move 1 step down 

mcub Move N steps left 

mcuf Move N steps right 

mcuu Move N steps up 

mcud Move N steps down 

mhpa Move N steps from the left 

mvpa Move N steps from the top 

The latter six strings are each used with a single argument, N. 


Sometimes the motion is limited to less than the width or length of a 
page. Also, some printers don’t accept absolute motion to the left of 
the current position, terminfo has capabilities for specifying these 
limits. 


Limits to Motion 

mjump Limit on use of mcubl, mcufl, mcuul, mcudl 

maddr Limit on use of mhpa, mvpa 

xhpa If set, hpa and mhpa can’t move left 

xvpa If set, vpa and mvpa can’t move up 

If a printer needs to be in a micro mode’ ’ for the motion capabilities 
described above to work, there are string capabilities defined to con¬ 
tain the control sequence to enter and exit this mode. A boolean is 
available for those printers where using a carriage return causes an 
automatic return to normal mode. 
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Entering/Exiting Micro Mode 

smicm Enter micro mode 
rmicm Exit micro mode 

crxm Using cr exits micro mode 

The movement made when a character is printed in the rightmost posi¬ 
tion varies among printers. Some make no movement, some move to 
the beginning of the next line, others move to the beginning of the 
same line, terminfo has boolean capabilities for describing all three 
cases. 


What Happens After Character 
Printed in Rightmost Position 

sam Automatic move to beginning of same line 

Some printers can be put in a mode where the normal direction of 
motion is reversed. This mode can be especially useful when there 
exists no capabilities for leftward or upward motion, because those 
capabilities can be built from the motion reversal capability and the 
rightward or downward motion capabilities. It is best to leave it up to 
an application to build the leftward or upward capabilities, though, 
and not enter them in the terminfo database. This allows several 
reverse motions to be strung together without intervening wasted steps 
that leave and reenter reverse mode. 

Entering/Exiting Reverse Modes 

slm Reverse sense of horizontal motions 
rim Restore sense of horizontal motions 
sum Reverse sense of vertical motions 

rum Restore sense of vertical motions 

While sense of horizontal motions reversed: 

mcubl Move 1 step right 

mcufl Move 1 step left 

mcub Move N steps right 

mcuf Move N steps left 

cubl Move 1 column right 

cufl Move 1 column left 

cub Move N columns right 

cuf Move N columns left 

While sense of vertical motions reversed: 

mcuul Move 1 step down 

mcudl Move 1 step up 

mcuu Move N steps down 

mcud Move N steps up 

cuul Move 1 line down 

cudl Move 1 line up 
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cuu Move N lines down 

cud Move N lines up 

The reverse motion modes should not affect the mvpa and mhpa abso¬ 
lute motion capabilities. The reverse vertical motion mode should, 
however, also reverse the action of the line “wrapping” that occurs 
when a character is printed in the right-most position. Thus printers 
that have the standard terminfo capability am defined should experi¬ 
ence motion to the beginning of the previous line when a character is 
printed in the right-most position under reverse vertical motion mode. 

The action when any other motion capabilities are used in reverse 
motion modes is not defined; thus, programs must exit reverse motion 
modes before using other motion capabilities. 

Two miscellaneous capabilities complete the list of new motion capa¬ 
bilities. One of these is needed for printers that move the current posi¬ 
tion to the beginning of a line when certain control characters, like 
line-feed or form-feed,” are used. The other is used for the capa¬ 
bility of suspending the motion that normally occurs after printing a 
character. 

__ Miscellaneous Motio n Strings 

doer List of control characters causing cr 

zerom Prevent auto motion after printing next single character 


Margins 

terminfo provides two strings for setting margins on terminals: one 
for the left and one for the right margin. Printers, however, have two 
additional margins, for the top and bottom margins of each page. 
Furthermore, some printers do not require using motion strings to 
move the current position to a margin and fixing the margin there, as 
with the existing capabilities, but require the specification of where a 
margin should be regardless of the current position. Therefore ter¬ 
minfo offers six additional strings for defining margins with printers. 

__ Setting Marg ins 

smgl Set left margin at current column 
smgr Set right margin at current column 

smgb Set soft bottom margin at current line 
smgt Set soft top margin at current line 

smgbp Set soft bottom margin at line N 
smglp Set soft left margin at column N 
smgrp Set soft right margin at column N 
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smgtp 

Set soft top margin at line N 

The last four strings are used with a single argument, N, that gives the 
line or column number, where line 0 is the top line and column 0 is the 

left-most column, 
left-most column. 

Note: Not all printers use 0 for the top line or the 

All margins can be cleared with mgc. 

Shadows, Italics, Wide Characters, Superscripts, Subscripts 

Five new sets of strings are used to describe the capabilities printers 
have of enhancing printed text. 


Enhanced Printing 

sshm 

Enter shadow-printing mode 

rshm 

Exit shadow-printing mode 

sitm 

Enter italicizing mode 

ritm 

Exit italicizing mode 

swidm 

Enter wide character mode 

rwidm 

Exit wide character mode 

ssupm 

Enter superscript mode 

rsupm 

Exit superscript mode 

supcs 

List of characters available as superscripts 

ssubm 

Enter subscript mode 

rsubm 

Exit subscript mode 

subcs 

List of characters available as subscripts 


If a printer requires the sshm control sequence before every character 
to be shadow-printed, the rshm string is left blank. Thus programs 
that find a control sequence in sshm but none in rshm should use the 
sshm control sequence before every character to be shadow-printed; 
otherwise, the sshm control sequence should be used once before the 
set of characters to be shadow-printed, followed by rshm. The same 
is also true of each of the sitm/ritm, swidm/rwidm, ssupm/rsupm, 
and ssubm/rsubm pairs. 

Note that terminfo also has a capability for printing emboldened text 
(bold). While shadow printing and emboldened printing are similar in 
that they “darken” the text, many printers produce these two types of 
print in slightly different ways. Generally, emboldened printing is 
done by overstriking the same character one or more times. Shadow 
printing likewise usually involves overstriking, but with a slight 
movement up and/or to the side so that the character is “fatter.” 

It is assumed that enhanced printing modes are independent modes, so 
that it would be possible, for instance, to shadow print italicized sub¬ 
scripts. 
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As mentioned earlier, the amount of motion automatically made after 
printing a wide character should be given in widcs. 

If only a subset of the printable ASCII characters can be printed as 
superscripts or subscripts, they should be listed in supcs or subcs 
strings, respectively. If the ssupm or ssubm strings contain control 
sequences, but the corresponding supcs or subcs strings are empty, it 
is assumed that all printable ASCII characters are available as super¬ 
scripts or subscripts. 

Automatic motion made after printing a superscript or subscript is 
assumed to be the same as for regular characters. Thus, for example, 
printing any of the following three examples will result in equivalent 
motion: 

Bi B. B 1 

Note that the existing msgr boolean capability describes whether 
motion control sequences can be used while in “standout mode.” 
This capability is extended to cover the enhanced printing modes 
added here, msgr should be set for those printers that accept any 
motion control sequences without affecting shadow, italicized, 
widened, superscript, or subscript printing. Conversely, if msgr is not 
set, a program should end these modes before attempting any motion. 


Section 2-5: Alternate Character Sets 

In addition to allowing you to define line graphics (described in Sec¬ 
tion 1-12), terminfo also lets you define alternate character sets. The 
following capabilities cover printers and terminals with multiple 
selectable or definable character sets. 


Alternate Character Sets 


scs Select character set A 

scsd Start definition of character set A, M characters 
defc Define character A, B dots wide, descender D 
rcsd End definition of character set A 
csnm List of character set names 
daisy Printer has manually changed print-wheels 


The scs, rcsd, and csnm strings are used with a single argument. A, a 
number from 0 to 63 that identifies the character set. The scsd string 
is also used with the argument A and another, M, that gives the 
number of characters in the set. The defc string is used with three 
arguments: A gives the ASCII code representation for the character, B 
gives the width of the character in dots, and D is zero or one depend¬ 
ing on whether the character is a “descender” or not. The defc string 
is also followed by a string of “image-data” bytes that describe how 
the character looks (see below). 
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Character set 0 is the default character set present after the printer has 
been initialized. Not every printer has 64 character sets, of course; 
using scs with an argument that doesn’t select an available character 
set should cause a null result from tparm{ ). 

If a character set has to be defined before it can be used, the scsd con¬ 
trol sequence is to be used before defining the character set, and the 
rcsd is to be used after. They should also cause a null result from 
tparm() when used with an argument N that doesn’t apply. If a char¬ 
acter set still has to be selected after being defined, the scs control 
sequence should follow the rcsd control sequence. By examining the 
results of using each of the scs, scsd, and rcsd strings with a character 
set number in a call to tparm (), a program can determine which of the 
three are needed. 

Between use of the scsd and rcsd strings, the defc string should be 
used to define each character. To print any character on printers 
covered by terminfo , the ASCII code is sent to the printer. This is true 
for characters in an alternate set as well as “normal” characters. 
Thus the definition of a character includes the ASCII code that 
represents it. In addition, the width of the character in dots is given, 
along with an indication of whether the character should descend’ 
below the print line (like the lower case letter “g” in most character 
sets). The width of the character in dots also indicates the number of 
image-data bytes that will follow the defc string. These image-data 
bytes indicate where in a dot-matrix pattern ink should be applied to 
“draw” the character; the number of these bytes and their form are 
defined below under "Dot-Mapped Graphics". 

It’s easiest for the creator of terminfo entries to refer to each character 
set by number; however, these numbers will be meaningless to the 
application developer. The csnm string alleviates this problem by 
providing names for each number. 

When used with a character set number in a call to tparm (), the csnm 
string will produce the equivalent name. These names should be used 
as a reference only. No naming convention is implied, although any¬ 
one who creates a terminfo entry for a printer should use names con¬ 
sistent with the names found in user documents for the printer. Appli¬ 
cation developers should allow a user to specify a character set by 
number (leaving it up to the user to examine the csnm string to deter¬ 
mine the correct number), or by name, where the application examines 
the csnm string to determine the corresponding character set number. 

These capabilities are likely to be used only with dot-matrix printers. 
If they are not available, the strings should not be defined. For printers 
that have manually changed print-wheels or font cartridges, the 
boolean daisy is set. 
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Section 2-6: Dot-Matrix Graphics 

Dot-matrix printers typically have the capability of reproducing 
“raster-graphics” images. Three new numeric capabilities and three 
new string capabilities can help a program draw raster-graphics 
images independent of the type of dot-matrix printer or the number of 
pins or dots the printer can handle at one time. 

Dot-Matrix Graphics 

npins Number of pins, N, in print-head 
spinv Spacing of pins vertically in pins per inch 
spinh Spacing of dots horizontally in dots per inch 
porder Matches software bits to print-head pins 
sbim Start printing bit image graphics, B bits wide 
rbim End printing bit image graphics 

The sbim sring is used with a single argument, B , the width of the 
image in dots. 

The model of dot-matrix or raster-graphics that the terminfo presents 
is similar to the technique used for most dot-matrix printers: Each 
pass of the printer’s print-head is assumed to produce a dot-matrix that 
is N dots high and B dots wide. This is typically a wide, squat, rectan¬ 
gle of dots. The height of this rectangle in dots will vary from one 
printer to the next; this is given in the npins numeric capability. The 
size of the rectangle in fractions of an inch will also vary; it can be 
deduced from the spinv and spinh numeric capabilities. With these 
three values an application can divide a complete raster-graphics 
image into several horizontal strips, perhaps interpolating to account 
for different dot spacing vertically and horizontally. 

The sbim and rbim strings are used to start and end a dot-matrix 
image, respectively. The sbim string is used with a single argument 
that gives the width of the dot-matrix in dots. A sequence of “image- 
data bytes” are sent to the printer after the sbim string and before the 
rbim string. The number of bytes is an integral multiple of the width 
of the dot-matrix; the multiple and the form of each byte is determined 
by the porder string as described below. 

The porder string is a comma separated list of pin numbers; the posi¬ 
tion of each pin number in the list corresponds to a bit in a data byte. 
The pins are numbered consecutively from 1 to npins, with 1 being 
the top pin. Note that the term “pin” is used loosely here; “ink-jet” 
dot-matrix printers don’t have pins, but can be considered to have an 
equivalent method of applying a single dot of ink to paper. The bit 
positions in porder are in groups of 8, with the first position in each 
group the most significant bit and the last position the least significant 
bit. 
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The “image-data bytes” are to be computed from the dot-matrix 
image, mapping vertical dot positions in each print-head pass into 
eight-bit bytes, using a 1 bit where ink should be applied and 0 where 
no ink should be applied. If a position is skipped in porder, a 0 bit is 
used. There must be a multiple of 8 bit positions used or skipped in 
porder; if not, 0 bits are used to fill the last byte in the least 
significant bits. 


Section 2-7: Effect of Changing Printing Resolution 

If the control sequences to change the character pitch or the line pitch 
are used, the pin or dot spacing may change: 

Dot-Matrix Graphics 
Changing the Character/Line Pitches 

cpi Change character pitch 

cpix If set, cpi changes spinh 

lpi Change line pitch 

lpix If set, lpi changes spinv 

Programs that use cpi or lpi should recalculate the dot spacing: 

Dot-Matrix Graphics 

Effects of Changing the Character/Line Pitches 
Before After 

Using cpi with cpix clear: 

spinh ’ spinh 


Using cpi with cpix set: 
spinh ’ 


spinh=spinh 


, orhi 
orhi' 


Using lpi with lpix clear: 
spinv ’ spinv 


Using lpi with lpix set: 

, ... orhi 

spinv spinv=spmv-— 

orhi 

Using chr: 

spinh 9 spinh 


Using cvr: 

spinv 9 spinv 


orhi’ and orhi are the values of the horizontal resolution in steps per 

inch, before using cpi and after using cpi, respectively. Likewise, 

orvi’ and orvi are the values of the vertical resolution in steps per 

inch, before using lpi and after using lpi, respectively. Thus, the 

changes in the dots per inch for dot-matrix graphics follow the 


March 15, 1989 


TERMINFO-53 









TERMINFO (M) 


TERMINFO (M) 


changes in steps per inch for printer resolution. 


Section 2-8: Print Quality 

Many dot-matrix printers can alter the dot spacing of printed text to 
produce near “letter quality” printing or “draft quality” printing. 
Usually it is important to be able to choose one or the other because 
the rate of printing generally falls off as the quality improves. There 
are three new strings used to describe these capabilities. 

Print Quality 

snlq Set near-letter quality print 

snrmq Set normal quality print 

sdrfq Set draft quality print 

The capabilities are listed in decreasing levels of quality. If a printer 
doesn’t have all three levels, one or two of the strings should be left 
blank as appropriate. 

Section 2-9: Printing Rate and Buffer Size 

Because there is no standard protocol that can be used to keep a pro¬ 
gram synchronized with a printer, and because modem printers can 
buffer data before printing it, a program generally cannot determine at 
any time what has been printed. Two new numeric capabilities can 
help a program estimate what has been printed. 

Print Rate/Buffer Size 

cps Nominal print rate in characters per second 

bufsz Buffer capacity in characters 

cps is the nominal or average rate at which the printer prints charac¬ 
ters; if this value is not given, the rate should be estimated at one- 
tenth the prevailing baud rate, bufsz is the maximum number of sub¬ 
sequent characters buffered before the guaranteed printing of an ear¬ 
lier character, assuming proper flow control has been used. If this 
value is not given it is assumed that the printer does not buffer charac¬ 
ters, but prints them as they are received. 

As an example, if a printer has a 1000-character buffer, then sending 
the letter “a” followed by 1000 additional characters is guaranteed to 
cause the letter “a” to print. If the same printer prints at the rate of 
100 characters per second, then it should take 10 seconds to print all 
the characters in the buffer, less if the buffer is not full. By keeping 
track of the characters sent to a printer, and knowing the print rate and 
buffer size, a program can synchronize itself with the printer. 
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Note that most printer manufacturers advertise the maximum print 
rate, not the nominal print rate. A good way to get a value to put in for 
cps is to generate a few pages of text, count the number of printable 
characters, then see how long it takes to print the text. 

Applications that use these values should recognize the variability in 
the print rate. Straight text, in short lines, with no embedded control 
sequences will probably print at close to the advertised print rate and 
probably faster than the rate in cps. Graphics data with a lot of con¬ 
trol sequences, or very long lines of text, will print at well below the 
advertised rate and below the rate in cps. If the application is using 
cps to decide how long it should take a printer to print a block of text, 
the application should pad the estimate. If the application is using cps 
to decide how much text has already been printed, it should shrink the 
estimate. The application will thus err in favor of the user, who wants, 
above all, to see all the output in its correct place. 


Files 

/usr/lib/terminfo/? /* 
/usr/lib/.COREterm/?/* 

compiled terminal description database 
subset of compiled terminal description 
database 

tab settings for some terminals, in a for¬ 
mat appropriate to be output to the ter¬ 
minal (escape sequences that set mar¬ 
gins and tabs) 

/usr/lib/tabset/* 

See Also 


tput(C), vi(C), captoinfo(ADM), infocmp(ADM), tic(C), term(M), 
curses(S), printf(S), profile(F), terminfo(F) 

Warning 



As described in the "Tabs and Initialization" section above, a 
terminal’s initialization strings, isl, is2, and is3, if defined, must be 
output before a curses (S) program is run. An available mechanism for 
outputting such strings is tput init [see tput(C) and profile^)]. 

If a null character (\0) is encountered in a string, the null and all char¬ 
acters after it are lost. Therefore it is not possible to code a null char¬ 
acter CO) and send it to a device (either terminal or printer). The 
suggestion of sending a0200, where a O (null) is needed can succeed 
only if the device (terminal or printer) ignores the eighth bit. For 
example, because all eight bits are used in the standard international 
ASCII character set, devices that adhere to this standard will treat 
'0200 differently fromO. 
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Tampering with entries in lusr/libl .COREterml?/* or 
/usr/lib/terminfo/?/* (for example, changing or removing an entry) can 
affect programs such as v/(C) that expect the entry to be present and 
correct. In particular, removing the description for the "dumb” termi¬ 
nal will cause unexpected problems. 
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termio 


general terminal interface 

Description 


All asynchronous communications ports use the same general inter¬ 
face, no matter what hardware is involved. The remainder of this sec¬ 
tion discusses the common features of this interface. 

When a terminal file is opened, it normally causes the process to wait 
until a connection is established. In practice, users’ programs seldom 
open these files; they are opened by getty (M) and become a user’s 
standard input, output, and error files. The very first terminal file 
opened by the process group leader of a terminal file not already asso¬ 
ciated with a process group becomes the “control terminal” for that 
process group. The control terminal plays a special role in handling 
quit and interrupt signals, as discussed below. The control terminal is 
inherited by a child process during afork(S). A process can break this 
association by changing its process group using setpgrp{ S). 

A terminal associated with one of these files ordinarily operates in 
full-duplex mode. Characters can be entered at any time, even while 
output is occurring, and are only lost when the system’s character 
input buffers become completely full, which is rare, or when the user 
has accumulated the maximum allowed number of input characters 
that have not yet been read by some program. Currently, this limit is 
256 characters. When the input limit is reached, all the saved charac¬ 
ters are thrown away without notice. 

Normally, terminal input is processed in units of lines. A line is del¬ 
imited by a newline (ASCII LF) character, an end-of-file (ASCII EOT) 
character, or an end-of-line character. This means that a program 
attempting to read will be suspended until an entire line has been 
entered. Also, no matter how many characters are requested in the 
read call, one line will be returned at most. It is not, however, neces¬ 
sary to read a whole line at once; any number of characters may be 
requested in a read, even one, without losing information. 

Erase and kill processing is normally done during input. By default, a 
Ctrl-H or BACKSPACE erases the last character typed, except that it 
will not erase beyond the beginning of the line. By default, a Ctrl-U 
kills (deletes) the entire input line, and optionally outputs a newline 
character. Both these characters operate on a key-stroke basis, 
independent of any backspacing or tabbing that may have been done. 
Both the erase and kill characters may be entered literally by preced¬ 
ing them with the escape character (\). In this case, the escape charac¬ 
ter is not read. The erase and kill characters may be changed (see 
stty( C)). 
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Certain characters have special functions on input. These functions 

and their default character values are summarized as follows: 

INTR (Rubout or ASCII DEL) Generates an interrupt signal which 
is sent to all processes with the associated control terminal. 
Normally, each such process is forced to terminate, but 
arrangements may be made either to ignore the signal or to 
receive a trap to an agreed-upon location; see signal (S). 

QUIT (Ctrl-\ or ASCII FS) Generates a quit signal. Its treatment is 
identical to the interrupt signal except that, unless a receiv¬ 
ing process has made other arrangements, it will not only be 
terminated, but a core image file (called core) will be 
created in the current working directory. 

SWTCH (ASCH NUL) Is used by the job control facility, shl{ C), to 
change the current layer to the control layer. 

ERASE (Ctrl-H) Erases the preceding character. It will not erase 
beyond the start of a line, as delimited by a NL, EOF, or EOL 
character. 

KILL (Ctrl-U) Deletes the entire line, as delimited by a NL, EOF, or 
EOL character. 

EOF (Ctrl-D or ASCII EOT) May be used to generate an end-of-file 
from a terminal. When received, all the characters waiting 
to be read are immediately passed to the program, without 
waiting for a newline, and the EOF is discarded. Thus, if 
there are no characters waiting, which is to say the EOF 
occurred at the beginning of a line, zero characters will be 
passed back, which is the standard end-of-file indication. 

NL (ASCH LF) Is the normal line delimiter. It cannot be changed 
or escaped. 

EOL (ASCH NUL) Is an additional line delimiter, like NL. It is not 
normally used. 

STOP (Ctrl-S or ASCII DC3) Temporarily suspends output. It is use¬ 
ful with CRT terminals to prevent output from disappearing 
before it can be read. While output is suspended, STOP char¬ 
acters are ignored and not read. 

START (Ctrl-Q or ASCII DC1) Resumes output which has been 
suspended by a STOP character. While output is not 
suspended, START characters are ignored and not read. The 
START/STOP characters cannot be changed or escaped. 

The character values for INTR, QUIT, SWTCH, ERASE, KILL, EOF, and 

EOL may be changed to suit individual tastes. The ERASE, KILL, and 

EOF characters may be escaped by a preceding backslash (\) character, 
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in which case no special function is carried out. 

When the carrier signal from the dataset drops, a “hangup” signal is 
sent to all processes that have this terminal as the control terminal. 
Unless other arrangements have been made, this signal causes the 
processes to terminate. If the hangup signal is ignored, any subse¬ 
quent read returns with an end-of-file indication. Thus, programs that 
read a te rminal and test for an end-of-file can terminate appropriately 
when hung up on. 

When one or more characters are written, they are transmitted to the 
te rminal as soon as the previously typed characters have been entered. 
Input characters are echoed by putting them in the output queue as 
they arrive. If a process produces characters more rapidly than they 
can be typed, it will be suspended when its output queue exceeds a 
given limit. When the queue has drained down to the given threshold, 
die program is resumed. 

Several ioctl(S) system calls apply to terminal files. The primary calls 
use the following structure, defined in the file <termio.h>: 

♦define NCC 8 
struct termio { 

unsigned short c_iflag; /* input inodes */ 
unsigned short c_oflag; /* output inodes */ 
unsigned short c_cflag; /* control inodes */ 
unsigned short c_lflag; /* local inodes */ 
char c_line; /* line discipline */ 

unsigned char c_cc [NCC]; /* control chars */ 

}; 

The special control characters are defined by the array c_cc . The rela¬ 
tive positions and initial values for each function are as follows: 


0 

VTNTR 

DEL 

1 

VQUIT 

FS 

2 

VERASE 

Ctrl-H 

3 

VKILL 

Ctrl-U 

4 

veof/vmin 

EOT 

5 

veol/vtime 

NUL 

6 

VEOL2 

EOL 

7 

VSWTCH 

NUL 


The cjflag field describes the basic terminal input control: 


IGNBRK 

0000001 

Ignores break condition 

BRKINT 

0000002 

Signals interrupt on break 

IGNPAR 

0000004 

Ignores characters with parity errors 

PARMRK 

0000010 

Marks parity errors 

INPCK 

0000020 

Enables input parity check 

ISTRIP 

0000040 

Strips character 

INLCR 

0000100 

Maps NL to CR on input 

IGNCR 

0000200 

Ignores CR 
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ICRNL 

IUCLC 

IXON 

IXANY 

IXOFF 


0000400 Maps CR to NL on input 
0001000 Maps uppercase to lowercase on input 
0002000 Enables start/stop output control 
0004000 Enables any character to restart output 
0010000 Enables start/stop input control 


If IGNBRK is set, the break condition (a character framing error with 
data all zeros) is ignored, that is, not put on the input queue and there¬ 
fore not read by any process. Otherwise, if BRKINT is set the break 
condition will generate an interrupt signal and flush both the input and 
output queues. If IGNPAR is set, characters with other framing and 
parity errors are ignored. 

If PARMRK is set, a character with a framing or parity error which is 
not ignored is read as the 3-character sequence: 0377, 0, X, where X 
is the data of the character received in error. To avoid ambiguity in 
this case, if ISTRIP is not set, a valid character of 0377 is read as 0377, 
0377. If PARMRK is not set, a framing or parity error which is not 
ignored is read as the character NUL (0). 

If INPCK is set, input parity checking is enabled. If INPCK is not set, 
input parity checking is disabled. This allows output parity generation 
without input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7-bits, other¬ 
wise all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR charac¬ 
ter. If IGNCR is set, a received CR character is ignored (not read). 
Otherwise, if ICRNL is set, a received CR character is translated into a 
NL character. 

If IUCLC is set, a received uppercase alphabetic character is translated 
into the corresponding lowercase character. 

If IXON is set, start/stop output control is enabled. A received STOP 
character will suspend output and a received START character will 
restart output. All start/stop characters are ignored and not read. If 
IXANY is set, any input character will restart output which has been 
suspended. 

If IXOFF is set, the system will transmit START characters when the 
input queue is nearly empty and STOP characters when nearly full. 

If CTSFLOW or RTSFLOW are set, IXON and IXANY should also be * 
set so that these two types of flow control do not interfere with each 
other. 

The RTS and CTS lines for the RS-232 (i.e. serial) interface were ori¬ 
ginally intended as handshaking signals between a Data Terminal 
Equipment (DTE) device (computer, printer, etc,) and a Data Com¬ 
munications Equipment (DCE) device (almost always a modem). The 
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RTS (Ready To Send) line is asserted by the DTE when it is ready to 
send data to the DCE. The DCE asserts the CTS (Clear To Send) line 
when it was ready to receive data. If the CTS line goes low, then the 
DTE should stop sending data until CTS goes high again. 

UNIX systems also use the RTS line for handshaking in the other 
direction. If the system sees that its input buffer is nearly full, it will 
lower the RTS line. The serial device should then stop sending, and 
wait for the system to catch up. The system will raise the RTS line 
when it is ready for more data. 

The initial input control value is all bits clear. 

The c_oflag field specifies the system treatment of output: 


OPOST 

0000001 

Postprocesses output 

OLCUC 

0000002 

Maps lowercase to uppercase on output 

ONLCR 

0000004 

Maps NL to CR-NL on output 

OCRNL 

0000010 

Maps CR to NL on output 

ONOCR 

0000020 

No CR output at column 0 

ONLRET 

0000040 

NL performs CR function 

OFILL 

0000100 

Uses fill characters for delay 

OFDEL 

0000200 

Fills is DEL, else NUL 

NLDLY 

0000400 

Selects newline delays: 

NLO 

0 


NL1 

0000400 


CRDLY 

0003000 

Selects carriage return delays: 

CRO 

0 


CR1 

0001000 


CR2 

0002000 


CR3 

0003000 


TABDLY 

0014000 

Selects horizontal tab delays: 

TABO 

0 


TAB1 

0004000 


TAB2 

0010000 


TAB3 

0014000 

Expands tabs to spaces 

BSDLY 

0020000 

Selects backspace delays: 

BSO 

0 


BS1 

0020000 


VTDLY 

0040000 

Selects vertical tab delays: 

VTO 

0 


VT1 

0040000 


FFDLY 

0100000 

Selects form feed delays: 

FFO 

0 


FF1 

0100000 



If OPOST is set, output characters are post-processed as indicated by 
the remaining flags, otherwise characters are transmitted without 
change. 

If OLCUC is set, a lowercase alphabetic character is transmitted as the 
corresponding uppercase character. This function is often used in con¬ 
junction with IUCLC. 
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If ONLCR is set, the NL character is transmitted as the CR-NL charac¬ 
ter pair. If OCRNL is set, the CR character is transmitted as the NL 
character. If ONOCR is set, no CR character is transmitted when at 
column 0 (first position). If ONLRET is set, the NL character is 
assumed to perform the carriage return function and the column 
pointer is set to 0 and the delays specified for CR will be used. Other¬ 
wise, the NL character is assumed to perform the linefeed function; 
the column pointer will remain unchanged. The column pointer is 
also set to 0 if the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for 
mechanical or other movement when certain characters are sent to the 
terminal. In all cases, a value of 0 indicates no delay. If OFILL is set, 
fill characters will be transmitted for delay instead of a timed delay. 
This is useful for high baud rate terminals which • ieed only a minimal 
delay. If OFDEL is set, the fill character is DEL, otherwise NUL. 

If a form feed or vertical tab delay is specified, it lasts for about 2 
seconds. 

Newline delay lasts about 0.10 seconds. If ONLRET is set, the car¬ 
riage return delays are used instead of the newline delays. If OFILL is 
set, 2 fill characters will be transmitted. 

Carnage return delay type 1 is dependent on the current column posi¬ 
tion, type 2 is about 0.10 seconds, and type 3 is about 0.15 seconds. If 
OFILL is set, delay type 1 transmits 2 fill characters, and type 2 
transmits 4 fill characters. 

Horizontal tab delay type 1 is dependent on the current column posi¬ 
tion. Type 2 is about 0.10 seconds. Type 3 specifies that tabs are to be 
expanded into spaces. If OFILL is set, 2 fill characters will be 
transmitted for any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, 1 fill char¬ 
acter will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The c_cflag field describes the hardware control of the terminal: 


CBAUD 

0000017 

Baud rate: 

B0 

0 

Hang up 

B50 

0000001 

50 baud 

B75 

0000002 

75 baud 

B110 

0000003 

110 baud 

B134 

0000004 

134.5 baud 

B150 

0000005 

150 baud 

B200 

0000006 

200 baud 

B300 

0000007 

300 baud 

B600 

0000010 

600 baud 
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B1200 

0000011 

1200 baud 

B1800 

0000012 

1800 baud 

B2400 

0000013 

2400 baud 

B4800 

0000014 

4800 baud 

B9600 

0000015 

9600 baud 

EXTA 

0000016 

External A 

EXTB 

0000017 

External B 

CSIZE 

0000060 

Character size: 

CS5 

0 

5 bits 

CS6 

0000020 

6 bits 

CS7 

0000040 

7 bits 

CS8 

0000060 

8 bits 

CSTOPB 

0000100 

Sends two stop bits, else one 

CREAD 

0000200 

Enables receiver 

PARENB 

0000400 

Parity enable 

PARODD 

0001000 

Odd parity, else even 

HUPCL 

0002000 

Hangs up on last close 

CLOCAL 

0004000 

Local line, else dial-up 

LOBLK 

0010000 

Block layer output 

CTSFLOW 

0020000 

Enables CTS protocol for a modem line 

RTSFLOW 

0040000 

Enables RTS signaling for a modem line 


The CBAUD bits specify the baud rate. The zero baud rate, BO, is used 
to hang up the connection. If BO is specified, the data-terminal-ready 
signal will not be asserted. Without this signal, the line is discon¬ 
nected if it is connected through a modem. For any particular 
hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both transmission 
and reception. This size does not include the parity bit, if any. If 
CSTOPB is set, 2 stop bits are used, otherwise 1 stop bit. For example, 
at 110 baud, 2 stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a par¬ 
ity bit is added to each character. If parity is enabled, the PARODD 
flag specifies odd parity if set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will 
be received. 

If HUPCL is set, the line will be disconnected when the last process 
with the line open closes it or terminates. That is, the data-terminal- 
ready signal will not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection 
with no modem control. The data-terminal-ready and request-to-send 
signals are asserted, but incoming modem signals are ignored. If 
CLOCAL is not set, modem control is assumed. This means the data- 
terminal-ready and request-to-send signals are asserted. Also, the 
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camer-detect signal must be returned before communications can 
proceed. 

If LOBLK is set, the output of a job control layer will be blocked when 
it is not the current layer. Otherwise the output generated by that 
layer will be multiplexed onto the current layer. 

The initial hardware control value after open is B9600, CS8, CREAD, 
HUPCL. 


The cjflag field of the argument structure is used by the line discip¬ 
line to control terminal functions. The basic line discipline (0) pro¬ 
vides the following: 


ISIG 

ICANON 

XCASE 

ECHO 

ECHOE 

ECHOK 

ECHONL 

NOFLSH 

XCLUDE 


0000001 

0000002 

0000004 

0000010 

0000020 

0000040 

0000100 

0000200 

0100000 


Enable signals 

Canonical input (erase and kill processing) 
Canonical upper/lower presentation 
Enables echo 

Echoes erase character as BS-SP-BS 
Echoes NL after kill character 
Echoes NL 

Disables flush after interrupt or quit 
Exclusive use of the line 


If ISIG is set, each input character is checked against the special con¬ 
trol characters INTO, SWTCH, and QUIT. If an input character 
matches one of these control characters, the function associated with 
that character is performed. If ISIG is not set, no checking is done. 
Thus, these special input functions are possible only if ISIG is set. 
These functions may be disabled individually by c hangin g the value of 
the control character to an unlikely or impossible value (e.g., 0377). 

If ICANON is set, canonical processing is enabled. This enables the 
erase and kill edit functions, and the assembly of input characters into 
lines delimited by NL, EOF, and EOL. If ICANON is not set, read 
requests are satisfied directly from the input queue. A read will not be 
satisfied until at least VMIN characters have been received or the 
timeout value VTIME has expired and at least one character has been 
input. This allows fast bursts of input to be read efficiently while still 
allowing single character input. (See the discussion of VMIN and 
VTIME below.) 


The VMIN and VTIME values are stored in the position for the EOF 
and EOL characters respectively. VMIN and VTIME are interpreted as 
EOF and EOL if ICANON is set. Default VMIN and VTIME values are 
stored in the /usr/include/sys/termio.h file. To change these values, 
set ICANON to off and use stty(C) to change the VMIN and VTIME 
values as represented by EOF and EOL. The TIME value represents 
tenths of seconds. 


If XCASE and ICANON are set, an uppercase letter is accepted on 
input by preceding it with a \ character, and is output preceded by a \ 
character. In this mode, the following escape sequences are generated 
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on output and accepted on input: 


For: 


{ 

} 

\ 


Use: 

V 


\! 

V 

\( 

\) 


For example, A is input as \a, \n as \\n, and \N as \\\n. 

If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possible. If 
ECHO and ECHOE are set, the erase character is echoed as ASCII BS 
SP BS, which will clear the last character from a CRT screen. If 
ECHOE is set and ECHO is not set, the erase character is echoed as 
ASCII SP BS. If ECHOK is set, the NL character will be echoed after 
the kill character to emphasize that the line will be deleted. Note that 
an escape character preceding the erase or kill character removes any 
special function. If ECHONL is set, the NL character will be echoed 
even if ECHO is not set. This is useful for terminals set to local echo 
(so-called half duplex). Unless escaped, the EOF character is not 
echoed. Because EOT is the default EOF character, this prevents ter¬ 
minals that respond to EOT from hanging up. 

If NOFLSH is set, the normal flush of the input and output queues asso¬ 
ciated with the quit and interrupt characters will not be done. 

If XCLUDE is set, any subsequent attempt to open the TTY device 
using open( S) will fail for all users except the super-user. If the call 
fails, it returns EBUSY in errno. XCLUDE is useful for programs 
which must have exclusive use of a communications line. It is not 
intended for the line to the program’s controlling terminal. XCLUDE 
must be cleared before the setting program terminates, otherwise sub¬ 
sequent attempts to open the device will fail. 

VMIN represents the minimum number of characters that should be 
received when the read is satisfied (i.e., the characters are returned to 
the user). VTIME is a timer of 0.10 second granularity used to time-out 
bursty and short-term data transmissions. The four possible values for 
VMIN and VTIME and their interactions are: 

VMIN > 0, VTIME > 0 

In this case, VTIME serves as an inter-character timer activated after 
the first character is received, and reset upon receipt of each character. 
VMIN and VTIME interact as follows: 

As soon as one character is received the inter-character timer is 
started. 
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If VMIN characters are received before the inter-character timer 
expires the read is satisfied. 

If the timer expires before VMIN characters are received the char¬ 
acters received to that point are returned to the user. 

A read( S) operation will sleep until the VMIN and VTIME mechan¬ 
isms are activated by the receipt of the first character; thus, at least 
one character must be returned. 

VMIN > 0, VTIME = 0 

In this case, because VTIME = 0, the timer plays no role and only 
VMIN is significant. A read(S) operation is not satisfied until VMIN 
characters are received. 

VMIN = 0, VTIME > 0 

In this case, because VMIN = 0, VTIME no longer serves as an inter¬ 
character timer, but now serves as a read timer that is activated as 
soon as the read( S) operation is processed. A read( S) operation is 
satisfied as soon as a single character is received or the timer expires, 
in which case, the read( S) operation will not return any characters. 

VMIN = 0, VTIME = 0 

In this case, return is immediate. If characters are present, they will 
be returned to the user. 

The initial line-discipline control value is all bits clear. 

The primary ioctl (S) system calls have the form: 

ioctl (fildes, command, arg) 
struct termio *arg; 


The commands 

using this form are: 

TCGETA 

Gets the parameters associated with the terminal and 
stores them in the termio structure referenced by arg. 

TCSETA 

Sets the parameters associated with the terminal from 
the structure referenced by arg. The change is 
immediate. 

TCSETAW 

Waits for the output to drain before setting the new 
parameters. This form should be used when changing 
parameters that will affect output. 

TCSETAF 

Waits for the output to drain, then flushes the input 
queue and sets the new parameters. 

Additional ioctl (S) calls have the form: 
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ioctl (hides, command, arg) 
int arg; 

The commands using this form are: 

TCSBRK 

Waits for the output to drain. If arg is 0, then sends a 
break (zero bits for 0.25 seconds). 

TCXONC 

Starts/stops control. If arg is 0, suspends output; if 1, 
restarts suspended output. 

TCFLSH 

If arg is 0, flushes the input queue; if 1, flushes the 
output queue; if 2, flushes both the input and output 
queues. 


Files 


/dev/tty 

/dev/tty* 

/dev/console 

See Also 

fork(S), ioctl(S), mapchan(F), mapchan(M), read(S), setgprp(S), 
signal(S), stty(C), tty(M), termios(M) 

Standards Conformance 


termio is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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termios _ 

POSIX general terminal interface 

Description 


This page discusses the POSIX termios extensions to the termio (M) 
interface. Only those functions not described in termio (M) are 
described here. 

Certain characters have special functions on input. These functions 
and their default character values are summarized as follows: 

SUSP (ASCH NUL) If the ISIG flag is enabled, receipt of the SUSP 
character causes A SIGTSTP signal to be sent to the current 
process group. The SUSP character is discarded when pro¬ 
cessed. It is normally set to Ctrl-Z. 

Several library functions apply to terminal files. The primary calls use 
the following structure, defined in the file <termios.h>: 


#define NCCS 

13 


struct termios 

{ 


tcflag_t 

c_iflag; 

/* input modes */ 

tcflag_t 

c_oflag; 

/* output modes */ 

tcflag_t 

c_cflag; 

/* control modes */ 

tcflag_t 

c_lflag; 

/* local (line discipline) modes */ 

char 

c line; 

/* line discipline */ 

cc_t 

c_cc [NCCS]; 

/* control chars */ 

char 

c_ispeed; 

/* input baud rate */ 

char 

c_ospeed; 

/* output baud rate */ 


}; 


The additional special control characters defined by the array c_cc. 
are: 

10 VSUSP NUL 

11 VS TART DC1 

12 VSTOP DC3 

The following additional line discipline (0) functions are available in 
the cjflag field: 

IEXTEN 0000400 enable extended functions 

TOSTOP 0001000 SIGTTOU on background output 

If IEXTEN is set, additional non-POSIX functions are recognized. This 
is the default. If IEXTEN is not set, the modes ICANON, ISIG, IXON, 
and EXOFF are assumed. 
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If TOSTOP is set, the signal SIGTTOU is sent to the process group of 
a process that tries to write to its controlling terminal if it is not the 
foreground process group. By default, this signal stops the members 
of the process group. If TOSTOP is not set, the output generated by the 
process is output to the current output stream. 

The associated library functions are found in tcattriS) and tcflow( S). 

Files 

/dev/tty 

/dev/tty* 

/dev/console 

See Also 

ioctl(S), signal(S), stty(C), tcattr(S), tcflow(S), termio(M), tty(M) 

Standards Conformance 


termios is conformant with: 

TF.F.P. POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 

and The X/Open Portability Guide II of January 1987. 
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Transport Interface cooperating STREAMS module 

Description 


timod is a STREAMS module for use with the Transport Interface (TI) 
functions of the Network Services library. The timod module converts 
a set of ioctl(S ) calls into STREAMS messages that may be consumed 
by a transport protocol provider which supports the Transport Inter¬ 
face. This allows a user to initiate certain TI functions as atomic 
operations. 

The timod module must only be pushed (see Streams Primer) onto a 
stream terminated by a transport protocol provider which supports the 


All STREAMS messages, with the exception of the message types gen¬ 
erated from the ioctl commands described below, will be transparently 
passed to the neighboring STREAMS module or driver. The messages 
generated from the following ioctl commands are recognized and pro¬ 
cessed by the timod module. The format of the ioctl call is: 

#include <sys/stropts.h> 


struct strioctl strioctl; 


strioctl.ic_cmd = cmd; 
strioctl.ic_timeout = EMFTIM; 
strioctl.ic_len = size; 
strioctl.ic_dp = (char *)buf 

ioctl(fildes, IJSTR, &strioctl); 

where, on issuance, size is the size of the appropriate TI message to be 
sent to the transport provider and on return, size is the size of the 
appropriate H message from the transport provider in response to the 
issued TI message, buf is a pointer to a buffer large enough to hold the 
contents of the appropriate TI messages. The TI message types are 
defined in <sys/tihdr.h>. The possible values for the cmd field are: 

TI_BIND Bind an address to the underlying transport protocol 

provider. The message issued to the TI_BIND ioctl 
is equivalent to the TI message type T_BIND_REQ 
and the message returned by the successful comple¬ 
tion of the ioctl is equivalent to the TI message type 
T_BIND_ACK. 
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TI_UNBIND Unbind an address from the underlying transport 
protocol provider. The message issued to the 
TLUNBIND ioctl is equivalent to the TI message 
type T_UNBIND_REQ and the message returned by 
the successful completion of the ioctl is equivalent 
to the TI message type T_OK_ACK. 


TI_GETINFO Get the TI protocol specific information from the 
transport protocol provider. The message issued to 
the TLGETINFO ioctl is equivalent to the TI mes¬ 
sage type T_INFO_REQ and the message returned 
by the successful completion of the ioctl is 
equivalent to the TI message type T_INFO_ACK. 

TI_OPTMGMT Get, set, or negotiate protocol specific options with 
the transport protocol provider. The message issued 
to the TI_OPTMGMT ioctl is equivalent to the TI 
message type T_OPTMGMT_REQ, and the message 
returned by the successful completion of the ioctl is 
equivalent to the TI message type 
T_OPTMGMT_ACK. 


Files 


<sys/timod.h> 

<sys/tiuser.h> 

<sys/tihdr.h> 

<sys/ermo.h> 

See Also 


tirdwr(M) 

STREAMS Primer 
STREAMS Programmer's Guide 
Network Programmer's Guide 

Diagnostics 

If the ioctl system call returns with a value greater than 0, the lower 8 
bits of the return value will be one of the TI error codes as defined in 
<sys/tiuser.h>. If the TI error is of type TSYSERR, then the next 8 bits 
of the return value will contain an error as defined in <sys/errno.h> 
[see intro(S)]. 
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timtbl _ 

create a time locale table 

Syntax 


timtbl [ specfile ] 

Description 


The utility timtbl is provided to allow new LC_TIME locales to be 
defined. It reads a specification file, which contains definitions of the 
way in which time and date information is presented for a particular 
locale, and produces a binary table file, to be read by setlocale (S), 
which determines the behavior of the strftime (S) routine. 

The information supplied in the specification file consists of lines in 
the following format: 

item - string 

The “=” can be separated from the item and string fields by zero or 
more space or tab characters. The following values are meaningful for 
item : 


DATE__FMT specification of the format string for representing the 
date. It will contain “%” directives representing vari¬ 
able items such as the month number, as used in fie for¬ 
mat string for strftime (S). 

TIME_FMT specification of the format string for representing the 
time of day. 

F_NOON string indicating 12-hour clock times before midday, 
e.g. “AM”. 

A_NOON string indicating 12-hour clock times after midday, e.g. 
“PM”. 

D_T_FMT string for formatting combined date and time. 

DAY_1 full name of the first day of the week (Sunday). 


DAY_7 full name of the seventh day of the week. 
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ABDAY_1 abbreviated name of the first day of the week, e.g. 
“Sun”. 


ABDAY_7 abbreviated name of the seventh day of the week. 
MON_l full name of the first month in the Gregorian calendar. 


MON_12 full name of the twelfth month. 

ABMON_l abbreviated name of the first month. 


ABMON_12 full name of the twelfth month. 

The string is a sequence of characters surrounded by quotes ("). Char¬ 
acters within the string can be specified both literally and using “\” 
escapes; the following three strings are equivalent: 

"Tuesday" - literal 

"\x54ue\x73da\x79" - hexadecimal escapes 

'\124ue\l 63da\l 71" - octal escapes 

The strings for the items DATEJFMT, TIME_FMT and DTJFMT will 
also include directives as detailed in the strftime( S) manual 

page, to specify variable portions of the string. 

All characters following a hash (“#”) are treated as a comment and 
ignored up to the end of the line, unless the hash is within a quoted 
string. 

The various items may be specified in any order. If any items are not 
specified, a warning message will be produced, and the null string ("") 
substituted. 

The binary table output is placed in a file named “time”, within the 
current directory. This file should be copied or linked to the correct 
place in the setlocale file tree (see locale (M)). To prevent accidental 
corruption of the output data, the file is created with no write permis¬ 
sion; if the timtbl utility is run in a directory containing a write- 
protected “ctype” file, the utility will ask if the existing file should be 
replaced - any response other than “yes” or “y” will cause timtbl to 
terminate without overwriting the existing file. 
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If the specfile argument is missing, the specification information is 
read from the standard input. 

See Also 


chrtbl(M), locale(M), numtbl(M), setlocale(S), strftime(S) 

Diagnostics 


If the input table file cannot be opened for reading, processing will ter¬ 
minate with the error message, “Cannot open specification file”. 

Any lines in the specification file which are syntactically incorrect, or 
contain an urecognized value for the item , will cause an error message 
to be issued to the standard error output, specifying the line number on 
which the error was detected. The line will be ignored, and processing 
will continue. 

If a particular item is specified more than once, a warning message 
will be produced, and processing will continue. 

If the specification file does not contain specifications for all possible 
items, a warning message will be produced. 

If the output file, time , cannot be opened for writing, processing will 
terminate with the error message, “Cannot create table file”. 

Any error conditions encountered will cause the program to exit with 
a non-zero return code; successful completion is indicated with a zero 
return code. 

Notes 


The strings D_FMT , T_FMT , AM_STR and PMJSTR may be used as 
alternatives to DATE_FMT , TIMEJFMT , F_NOON and A_NOON 
respectively, if required. These alternatives are provided for con¬ 
sistency with the identifiers used by nl_langinfo( S). 

Value Added 


timtbl is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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tirdwr _ 

Transport Interface read/write interface STREAMS 
module 

Description 


tirdwr is a STREAMS module that provides an alternate interface to a 
transport provider which supports the Transport Interface (TI) func¬ 
tions of the Network Services library (see Section 3N). This alternate 
interface allows a user to communicate with the transport protocol 
provider using the read( S) and write{ S) system calls. The putmsg( S) 
and getmsg( S) system calls may also be used. However, putmsg and 
getmsg can only transfer data messages between user and stream. 

The tirdwr module must only be pushed [see I_PUSH in streamio( M)] 
onto a stream terminated by a transport protocol provider which sup¬ 
ports the TI. After the tirdwr module has been pushed onto a stream , 
none of the Transport Interface functions can be used. Subsequent 
calls to TI functions will cause an error on the stream. Once the error 
is detected, subsequent system calls on the stream will return an error 
with errno set to EPROTO. 

The following are the actions taken by the tirdwr module when pushed 
on the stream^ popped [see I_POP in streamio( M)] off the stream 9 or 
when data passes through it. 

push - When the module is pushed onto a stream , it will check 
any existing data destined for the user to ensure that only 
regular data messages are present. It will ignore any mes¬ 
sages on the stream that relate to process management, 
such as messages that generate signals to the user pro¬ 
cesses associated with the stream. If any other messages 
are present, the I_PUSH will return an error with errno set 
to EPROTO. 

write - The module will take the following actions on data that 
originated from a write system call: 

All messages with the exception of messages that con¬ 
tain control portions (see the putmsg and getmsg sys¬ 
tem calls) will be transparently passed onto the 
module’s downstream neighbor. 

- Any zero length data messages will be freed by the 
module and they will not be passed onto the module’s 
downstream neighbor. 
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- Any messages with control portions will generate an 
error, and any further system calls associated with the 
stream will fail with errno set to EPROTO. 

read - The module will take the following actions on data that 
originated from the transport protocol provider: 

- All messages with the exception of those that contain 
control portions (see the putmsg and getmsg system 
calls) will be transparently passed onto the module’s 
upstream neighbor. 

- The action taken on messages with control portions 
will be as follows: 

+ Messages that represent expedited data will 
generate an error. All further system calls asso¬ 
ciated with the stream will fail with errno set to 
EPROTO. 

+ Any data messages with control portions will 
have the control portions removed from the 
message prior to passing the message to the 
upstream neighbor. 

+ Messages that represent an orderly release indi¬ 
cation from the transport provider will generate 
a zero length data message, indicating the end 
of file, which will be sent to the reader of the 
stream. The orderly release message itself will 
be freed by the module. 

+ Messages that represent an abortive disconnect 
indication from the transport provider will cause 
all further write and putmsg system calls to fail 
with errno set to ENXIO. All further read and 
getmsg system calls will return zero length data 
(indicating end of file) once all previous data 
has been read. 

+ With the exception of the above rules, all other 
messages with control portions will generate an 
error and all further system calls associated with 
the stream will fail with errno set to EPROTO. 

- Any zero length data messages will be freed by the 
module and they will not be passed onto the module’s 
upstream neighbor. 

pop - When the module is popped off the stream or the stream is 
closed, the module will take the following action: 
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- If an orderly release indication has been previously 
received, then an orderly release request will be sent 
to the remote side of the transport connection. 

See Also 


streamio(M), timod(M), intro(S), getmsg(S), putmsg(S), read(S), 
write(S), intro(S) 

STREAMS Primer 
STREAMS Programmer’s Guide 
Network Programmer’s Guide 
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trchan _ 

translate character sets 

Syntax 


trchan [-ciko] mapfile 

Description 


trchan performs mapping as a filter, using the same format of mapfile 
as mapchan{ M) (described in mapchan(F)). This allows a file consist¬ 
ing of one internal character set to be “translated’ ’ to another internal 
character set. 

trchan reads standard input, maps it, and writes to standard output. A 
mapfile must be given on the command line. Errors cause trchan to 
stop processing unless -c is specified. 

The following options can be used with trchan : 

-c causes errors to be echoed on stderr , and processing is continued. 

-i specifies that the “input” section of the mapfile is used when 
translating data. 

-k specifies that the “dead” and “compose” sections of the mapfile 
are used when translating data. 

-o specifies that the “output” section of the mapfile is used when 
translating data. 

The -i, -k and -o options can be specified in any combination; if 
none are specified, trchan uses the entire mapfile , as if all three 
were specified together. 


Files 


/usr/lib/mapchan/* 

See Also 


ascii(M), mapchan(F), mapchan(M) 


March 15,1989 


TRCHAN-1 











TRCHAN (M) 


TRCHAN(M) 


Notes 

trchan currently ignores the control sections of the mapfile. 

Value Added 


trchan is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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tty_ 

special terminal interface 

Description 


The file /dev/tty is, in each process, a synonym for the control termi¬ 
nal associated with the process group of that process, if any. It is use- 
ful for programs or shell sequences that wish to be sure of writing 
messages on the terminal no matter how output has been redirected. It 
can also be used for programs that demand the name of a file for out¬ 
put, when typed output is desired, and when it is tiresome to find out 
what terminal is currently in use. 

The general terminal interface is described in termio(M). 

Files 


/dev/tty 

/dev/tty* 

See Also 


termio(M) 

Standards Conformance 


tty is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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time zone environment variable 


Syntax 

/etc/tz 

Description 

TZ is the shell environment variable for the time zone of the system 
and is set in the files /etc/default/login and /etc/TIMEZONE (see 
timezone(F) for a complete description of the syntax for defining TZ). 

The shell script /etc/tz, generally run during installation, prompts for 
the correct time zone, prompts for the dates when time is shifted from 
standard to daylight time and back, and for the number of hours to 
shift (partial hours in the form of hh:mm:ss are acceptable), and sets 
TZ correctly in the appropriate files. The following files are exam¬ 
ined to see if they read from /etc/TIMEZONE to set TZ for their 
environment: 

/etc/cshrc 

/etc/profile 

/etc/rc2 

/.profile 

If these files do not read from /etc/TIMEZONE, a warning is issued. 

Users living in a time zone different than that of the host machine may 
change TZ in their $HOME/.profile or $HOME/.login files. 

To change the time zone for the entire system, run the shell script 
/etc/tz (as root) or use an editor to change the variable TZ in the files 
/etc/TIMEZONE and /etc/default/login. The TZ variable in 
/etc/default/login causes the time zone to be set correctly on logging 
in and for programs such as uucico. 

Files 


/etc/rc2 

/etc/default/login 

/ptr/t7 

$HOME/.profile 

$HOME/.login 
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See Also 


TZ (M) 


environ(M), date(C), timezone(F), ctime(S) 

Notes 


The date(C) automatically switches from Standard Time to Summer 
Time (Daylight Saving Time). Leap days are properly accounted for. 

Changes to TZ are immediately effective, (i.e. if a process changes the 
TZ variable, the next call to a dime (S) routine returns a value based 
on the new value of the variable). 
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values _ 

machine-dependent values 

Syntax 

#include <values.h> 

Description 


This file contains a set of manifest constants, conditionally defined for 
particular processor architectures. 

The model assumed for integers is binary representation (one’s or 
two’s complement), where the sign is represented by the value of the 
high-order bit. 

BITS (type) The number of bits in a specified type (e.g., 

int). 


fflBITS 


HIBITL 


HIBITI 


The value of a short integer with only the 
high-order bit set (in most implementations, 
0x8000). 

The value of a long integer with only the 
high-order bit set (in most implementations, 
0x80000000). 

The value of a regular integer with only the 
high-order bit set (usually the same as HIBITS 
or HIBITL). 


MAXSHORT The maximum value of a signed short integer 

(in most implementations, 0x7FFF = 32767). 

MAXLONG The maximum value of a signed long integ er 

(in most implementations, 0x7FFFFFFF = 
2147483647). 

MAXINT The maximum value of a signed regular 

integer (usually the same as MAXSHORT or 
MAXLONG). 


MAXFLOAT, LN_MAXFLOAT The maximum value of a single¬ 
precision floating-point number, 
and its natural logarithm. 
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MAXDOUBLE, LN_MAXDOUBLE 


MINFLOAT, LN.MINFLO AT 


MINDOUBLE, LN_MINDOUBLE 


The maximum value of a 

double-precision floating-point 
number, and its natural loga¬ 

rithm. 

The minimum positive value of a 
single-precision floating-point 
number, and its natural loga¬ 

rithm. 

The minimum positive value of a 
double-precision floating-point 
number, and its natural loga¬ 

rithm. 


FSIGNIF 

DSIGNIF 

See Also 


The number of significant bits in the mantissa 
of a single-precision floating-point number. 

The number of significant bits in the mantissa 
of a double-precision floating-point number. 


intro(S), limits(F), math(M) 

Standards Conformance 


values is conformant with: 

The X/Open Portability Guide II of January 1987. 
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xtproto __ 

multiplexed channels protocol used by xt(HW) driver 

Description 

The .rf(HW) driver contains routines which implement a multiplexed, 
multi-buffered, full-duplex protocol with guaranteed delivery of 
ordered data via an 8-bit byte data stream. This protocol is used for 
communication between multiple UNIX system host processes and an 
AT&T windowing terminal operating under layers(C). 

The protocol uses packets with a 2-byte header containing a 3-bit 
sequence number, 3-bit channel number, control flag, and data size. 
The data part of a packet may not be larger than 32 bytes. The trailer 
contains a CRC-16 code in 2 bytes. Each channel is double-buffered. 

Correctly received packets in sequence are acknowledged with a con¬ 
trol packet containing an ACK; however, out of sequence packets gen¬ 
erate a control packet containing a NAK, which will cause the 
retransmission in sequence of all unacknowledged packets. 

Unacknowledged packets are retransmitted after a timeout interval 
which is dependent on baud rate. Another timeout parameter specifies 
the interval after which incomplete receive packets are discarded. 

Files 


/usr/include/sys/xtproto.h channel multiplexing protocol definitions 

See Also 


layers(M), layers(C), xt(HW) 
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Permuted Index 

Commands, System Calls, Library Routines and File Formats 


This permuted index is derived from the “Name” description lines found on each 
reference manual page. Each index line shows the title of the entry to which the line 
refers, followed by the reference manual section letter where the page is found. 

To use the permuted index search the middle column for a key word or phrase. The right 
hand column contains the name and section letter of the manual page that documents 
the key word or phrase. The left column contains additional useful information about 
the command. Commands or routines are also listed in the context of the index line, 
followed by a colon (:). This denotes the “beginning” of the sentence. Notice that in 
many cases, the lines wrap, starting in the middle column and ending in the left column. 
A slash (/) indicates that the description line is truncated. 
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300 and 300s terminals /special 
450 terminal /handle special . . . 

backup functions . 

file system volcopy: make .... 
filesystems for optimal access . . 
format, fa. XENIX-style Micnet . . 
format. Converts XENIX-style . . 

format. /UUCP . 

hashed database of alias and . . . 

incremental file system/. 

incremental filesystem backup/ . . 
incremental filesystem backup. . . 

routing file to MMDF/. 

names id: print . 

300: 300, 300s - handle special . . 


300(C) 

300(C) 

450(C) 

backup(ADM) 

dcopy(ADM) 

dbmbuild(ADM) 

dbmbuild(ADM) 

xrestore(ADM) 

restore(ADM) 

xbackup(ADM) 

uulist(ADM) 

uulist(ADM) 

link_unix(ADM) 

profiler(ADM) 

fs(F) 

300(C) 

450(C) 

backup(ADM) 

volcopy(ADM) 

dcopy(ADM) 

mnlist(ADM) 

mmdfalias(ADM) 

uulist(ADM) 

dbmbuild(ADM) 

xrestore(ADM) 

restore(ADM) 

xbackup(ADM) 

uulist(ADM) 

id(ADM) 

300(C) 
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DASI/ 300: 300, 300s - handle special functions of ... . 300(C) 

DASI300/ 300: 300,300s handle special functions of ... . 300(C) 
of DASI 300/ 300: 300, 300s - handle special functions . . 300(C) 
functions of DASI/ 300: 300,300s - handle special .... 300(C) 

coffconv: Convert 386 COFF files to XENIX format. . coffconv(M) 
13tol, ltol3: Converts between 3-byte integers and long/ .... 13tol(S) 

TEKTRONIX 4014 terminal 4014: paginator for the .4014(C) 

paginator for the TEKTRONIX 4014 terminal 4014: . 4014(C) 

the DASI 450 terminal 450: handle special functions of . 450(C) 

DASI 450 terminal 450: handle special functions of the . . 450(C) 

accepts a number of 512-byte blocks.login(M) 

/object downloader for the 5620 DMD terminal .wtinit(ADM) 

between long integer and base 64 ASCII. a641,164a: Converts . . a641(S) 

i286emul: emulate 80286 .i286emul(C) 

x286emul: emulate XENIX 80286 x286emul(C) 

Object Modules. 86rel: Intel 8086 Relocatable Format for ... 86rel(F) 
asx: XENIX 8086/186/286/386 Assembler. . . asx(CP) 

Format for Object Modules. 86rel: Intel 8086 Relocatable . . . 86rel(F) 

long integer and base 64 ASCII. a641,164a: Converts between . . . a641(S) 

Format of UUCP dial-code abbreviations file, dialcodes: . . . dialcodes(F) 

abort: Generates an IOT fault. . . abort(S) 

value, abs: Returns an integer absolute . abs(S) 

abs: Returns an integer absolute value.abs(S) 

and/ /fabs, ceil, fmod: Performs absolute value, floor, ceiling . . . floor(S) 

integer, labs: Returns the absolute value of a long.labs(DOS) 

blocks, accepts a number of 512-byte . . login(M) 

files, settime: Changes the access and modification dates of . settime(ADM) 

a file, touch: Updates access and modification times of . touch(C) 

utime: Sets file access and modification times. . . utime(S) 

of a file, access: Determines accessibility . access(S) 

dosls, dosrm, dosrmdir: Access DOS files.dos(C) 

directory, chmod: Changes the access permissions of a file or . . chmod(C) 

ldfcn: common object file access routines .ldfcn(F) 

sulogin: access single-user mode.sulogin(ADM) 

filesystems for optimal access time /copy UNIX .... dcopy(ADM) 
a/ /nbwaitsem: Awaits and checks access to a resource governed by . waitsem(S) 

sdenter, sdleave: Synchronizes access to a shared data segment. . sdenter(S) 

sputl, sgetl: Accesses long integer data in a/ . . sputl(S) 

endutent, utmpname: Accesses utmp file entry.getut(S) 

access: Determines accessibility of a file.access(S) 

Synchronizes shared data access, sdgetv, sdwaitv: .... sdgetv(S) 

csplit: Splits files according to context.csplit(C) 

accton: Turns on accounting.accton(ADM) 

/accton, acctwtmp - overview of accounting and miscellaneous/ . . acct(ADM) 
of accounting and miscellaneous accounting commands /- overview acct(ADM) 

diskusg: generate disk accounting data by user ID ... . diskusg(ADM) 

acct: Format of per-process accounting file.acct(F) 

acctmerg: merge or add total accounting files .acctmerg(ADM) 

Searches for and prints process accounting files, acctcom: .... acctcom(ADM) 
command summary from per-process accounting records acctcms: . . . acctcms(ADM) 
wtmpfix: manipulate connect accounting records /fwtmp, . . . fwtmp(ADM) 
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imacct: Generate an IMAGEN accounting report.imacct(C) 

runacct: run daily accounting ..runacct(ADM) 

Enables or disables process accounting, acct: .acct(S) 

acctprcl, acctprc2-process accounting acctprc: .acctprc(ADM) 

tumacct - shell procedures for accounting /shutacct, startup, . . acctsh(ADM) 

accton, acctwtmp - overview of/ acct: acctdisk, acctdusg,.acct(ADM) 

process accounting, acct: Enables or disables .... acct(S) 
accounting file, acct: Format of per-process . . . acct(F) 

per-process accounting records acctcms: command summary from . acctcms(ADM) 
process accounting files, acctcom: Searches for and prints . acctcom(ADM) 
acctwtmp - overview of/ acct: acctdisk, acctdusg, accton, .... acct(ADM) 
overview of/ acct: acctdisk, acctdusg, accton, acctwtmp - . . . acct(ADM) 

accounting files acctmerg: merge or add total . . . acctmerg(ADM) 

acct: acctdisk, acctdusg, accton, acctwtmp - overview of/ . acct(ADM) 
accton: Turns on accounting. . . . accton(ADM) 
process accounting acctprc: acctprcl, acctprc2 - ... acctprc(ADM) 

accounting acctprc: acctprcl, acctprc2 - process . . . acctprc(ADM) 

acctprc: acctprcl, acctprc2 - process accounting . . acctprc(ADM) 
dodisk, lastlogin, monacct,/ acctsh: chargefee, ckpacct, . . . acctsh(ADM) 

acctdisk, acctdusg, accton, acctwtmp - overview of/ acct: . . acct(ADM) 

sin, cos, tan, asin, acos, atan, atan2: Performs/ . . . trig(S) 

initcond: special security actions for init and getty.initcond(ADM) 

/interface for audit subsystem activation, termination,.auditcmd(ADM) 

killall: kill all active processes.killall(ADM) 

sag: system activity graph.sag(ADM) 

sar, sal, sa2, sadc - system activity report package sar: . . . sar(ADM) 

Prints current SCCS file editing activity, sact:.sact(CP) 

report process data and system activity timex: time a command; . timex(ADM) 

information about system activity, uptime: Displays .... uptime(C) 

debugger, adb: Invokes a general-purpose . . adb(CP) 

device driver/ idinstall: add, delete, update, or get .... idinstall(ADM) 
acctmerg: merge or add total accounting files .... acctmerg(ADM) 

Copies bytes from a specific address, movedata: .movedata(DOS) 

nl: Adds line numbers to a file. . . . nl(C) 

lineprinters. lpinit: Adds, reconfigures and maintains . lpinit(ADM) 

swapadd: Adds swap area.swapadd(S) 

putenv: Changes or adds value to environment. . . . putenv(S) 

SCCS files, admin: Creates and administers . . admin(CP) 

LP print service lpfilter: administer filters used with the . . lpfilter(ADM) 

LP print service lpforms: administer forms used with the . . lpforms(ADM) 

admin: Creates and administers SCCS files.admin(CP) 

netutil: Administers the XENIX network. . netutil(ADM) 

uuinstall: Administers UUCP control files. . uuinstall(ADM) 

/Menu driven at and cron administration utility.atcronsh(ADM) 

auditsh: Menu driven audit administration utility.auditsh(ADM) 

backupsh: Menu driven backup administration utility.backupsh(ADM) 

sysadmsh: Menu driven system administration utility.sysadmsh(ADM) 

Menu driven lp print service administration utility lpsh: . . . lpsh(ADM) 

network listener service administration nlsadmin: .... nlsadmin(ADM) 

uadmin: administrative control .uadmin(ADM) 

uadmin: administrative control.uadmin(S) 
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swap: swap 
authorization/ authtsh: 
alarm: Sets a process* 
clock. 

mmdfalias: converts XENIX-style 
brkctl: 

malloc, free, realloc, calloc: 
brk: Changes data segment space 
file, inittab: 
reduce: perform audit data 
Generates programs for lexical 
temporarily privs: print 
link editor output. 

libraries, 
dc: Invokes an 
cpio: Format of cpio 
pax: portable 
ar: 
tar: 

the names of files on a backup 
ar: Maintains 
tar: 

cpio: Copies file 
ranlib: Converts 
swapadd: Adds swap 
varargs: variable 
output of a varargs 
getopt: Gets option letter from 
expr: Evaluates 
echo: Echoes 
ascii: Map of the 
character set. 
atof, atoi, atol: Converts 
between long integer and base 64 
tzset: Converts date and time to 
and/ crime, localtime, gmtime, 
Performs/ sin, cos, tan, 
commands, help: 
time of day. 
output. a.out: Format of 
asx: XENIX 8086/186/286/386 
masm: Invokes the XENIX 
program, 
deassigns devices, 
assign, deassign: 
setbuf, setvbuf: 
setkey: 

Close the event queue and all 
Assembler, 
a later time. 


administrative interface. 

administrator interface for .... 

alarm clock. 

alarm: Sets a process’ alarm . . . 

aliases file to MMDF/. 

Allocates data in a far segment. . . 

Allocates main memory. 

allocation, sbrk,. 

Alternative login terminals . . . 

analysis and reduction . 

analysis, lex:. 

and/or restrict privileges. 

a.out: Format of assembler and . . 

ar: Archive file format. 

ar: Maintains archives and .... 
arbitrary precision calculator. . . 

archive. 

archive exchange . 

Archive file format. 

archive format. 

archive, dumpdir: Prints .... 

archives and libraries. 

Archives files. 

archives in and out. 

archives to random libraries. . . . 

area. 

argument list. 

argument list. /Prints formatted . . 

argument vector. 

arguments as an expression. . . . 

arguments. 

ASCII character set. 

ascii: Map of the ASCII. 

ASCII to numbers. 

ASCH. a641,164a: Converts . . . 
ASCII, /gmtime, asctime, . . . . 
asctime, tzset: Converts date . . . 

asin, acos, atan, atan2: . 

Asks for help about SCCS . . . . 
asktime: Prompts for the correct 
assembler and link editor .... 

Assembler. 

assembler. 

assert: Helps verify validity of . . 
assign, deassign: Assigns and . . 
Assigns and deassigns devices. . . 
Assigns buffering to a stream. . . 

Assigns the function keys. 

associated devices. ev_close: . . 

asx: XENIX 8086/186/286/386 . . 

at, batch: Executes commands at 


swap(ADM) 

authtsh(ADM) 

alarm(S) 

alarm(S) 

mmdfalias(ADM) 

brkctl(S) 

malloc(S) 

sbrk(S) 

inittab(F) 

reduce(ADM) 

lex(CP) 

privs(C) 

a.out(F) 

ar(F) 

ar(CP) 

dc(C) 

cpio(F) 

pax(C) 

ar(F) 

tar(F) 

dumpdir(C) 

ar(CP) 

tar(C) 

cpio(C) 

ranlib(CP) 

swapadd(S) 

varargs(S) 

vprintf(S) 

getopt(S) 

expr(C) 

echo(C) 

ascii(M) 

ascii(M) 

atof(S) 

a641(S) 

ctime(S) 

ctime(S) 

trig(S) 

help(CP) 

asktime(ADM) 

a.out(F) 

asx(CP) 

masm(CP) 

assert(S) 

assign(C) 

assign(C) 

setbuf(S) 

setkey(C) 

ev_close(S) 

asx(CP) 

at(C) 
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sin, cos, tan, asin, acos, atan, atan2: Performs/.trig(S) 

sin, cos, tan, asin, acos, atan, atan2: Performs trigonometric/ . . trig(S) 
cron administration utility atcronsh: Menu driven at and . . . atcronsh(ADM) 
to numbers, atof, atoi, atol: Converts ASCII . . atof(S) 
double-precision/ strtod, atof: Converts a string to a .... strtod(S) 
numbers, atof, atoi, atol: Converts ASCII to . . . atof(S) 

integer, strtol, atol, atoi: Converts string to .strtol(S) 

integer, strtol, atol, atoi: Converts string to ... strtol(S) 
atof, atoi, atol: Converts ASCII to numbers. . atof(S) 
filesystem backup/ restore: AT&T UNIX incremental .... restore(ADM) 

QIC-24/QIC-02 tape/ tapecntl: AT&T tape control for .tapecntl(C) 

xt: multiplexed tty driver for AT&T windowing terminals . . . xt(HW) 

/Print file to printer attached to a serial console . . . consoleprint(ADM) 

lprint: Print to a printer attached to the user’s terminal . . lprint(C) 

data segment, sdget, sdfree: Attaches and detaches a shared . . sdget(S) 

tunable parameter idtune: attempts to set value of a .... idtune(ADM) 
auditsh: Menu driven audit administration utility .... auditsh(ADM) 
device audit: audit subsystem interface . . audit(ADM) 

by the audit/ auditd: read audit collection files generated . . auditd(ADM) 

reduction reduce: perform audit data analysis and .reduce(ADM) 

events dlvr_audit: produce audit records for subsystem . . . dlvr_audit(ADM) 

auditcmd: command interface for audit subsystem activation,/ . . . auditcmd(ADM) 

files generated by the audit subsystem and /collection . auditd(ADM) 
audit: audit subsystem interface device . audit(ADM) 
audit subsystem activation,/ auditcmd: command interface for . auditcmd(ADM) 
files generated by the audit/ auditd: read audit collection . . . auditd(ADM) 

chg_audit: enables and disable auditing for the next session . . . chg_audit( ADM) 

administration utility auditsh: Menu driven audit . . . auditsh(ADM) 

authcap: authentication database . authcap(ADM) 

consistency of Authentication/ authck: check internal .authck(ADM) 

authcap: authentication database.authcap(ADM) 

/examine system files against authentication database.integrity(ADM) 

check internal consistency of Authentication database authck: . authck(ADM) 

/administrator interface for authorization subsystem.authtsh(ADM) 

for authorization subsystem authtsh: administrator interface . . authtsh(ADM) 

the system, autoboot: Automatically boots . . autoboot(ADM) 

schedule: Database for automated system backups .... schedule(ADM) 
autoboot: Automatically boots the system. . autoboot(ADM) 
resource/ waitsem, nbwaitsem: Awaits and checks access to a . . waitsem(S) 

processes, wait: Awaits completion of background . wait(C) 
a pattern in a file, awk: Searches for and processes . awk(C) 

wait: Awaits completion of background processes.wait(C) 

backupsh: Menu driven backup administration utility . . . backupsh(ADM) 

Prints the names of files on a backup archive, dumpdir: .... dumpdir(C) 

sddate: Prints and sets backup dates.sddate(C) 

/Default backup device information. . . . archive(F) 

format, backup: Incremental dump tape . . backup(F) 

file system backup, backup: Performs incremental . . backup(ADM) 

backup functions backup: performs UNIX.backup(ADM) 

incremental filesystem backup restore /UNIX .restore(ADM) 

Performs incremental file system backup, backup: .backup(ADM) 
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error-checking filesystem backup fsave: Interactive, .... fsave(ADM) 
incremental filesystem backup. /Performs XENIX .... xbackup(ADM) 
periodic semi-automated system backups fsphoto: Performs . . . fsphoto(ADM) 
administration utility backupsh: Menu driven backup . . backupsh(ADM) 

Database for automated system backups schedule:.schedule(ADM) 

fixed disk for flaws and creates bad track table, badtrk: Scans . . badtrk(ADM) 

flaws and creates bad track/ badtrk: Scans fixed disk for ... badtrk(ADM) 

banner: Prints large letters.banner(C) 

between long integer and base 64 ASCII. /164a: Converts . . a641(S) 

and sets the configuration data base, cmos: Displays.cmos(HW) 

and sets the configuration data base, cmos: Displays.cmos(HW-86) 

names from pathnames, basename: Removes directory . . basename(C) 

Terminal capability data base, termcap: .termcap(M) 

terminal capability data base, terminfo: .terminfo(M) 

later time, at, batch: Executes commands at a . . at(C) 

be: Invokes a calculator.bc(C) 

initialization/ bre: bre, bcheckrc - system .brc(ADM) 

for diff. bdiffi Compares files too large . . bdiff(C) 

bdos: Invokes a DOS system call. . bdos(DOS) 

cb: Beautifies C programs.cb(CP) 

jO,jl,jn, yO, yl,yn: Performs Bessel functions, bessel, .... bessel(S) 

Performs Bessel functions, bessel, jO,jl,jn, yO, yl, yn: . . . bessel(S) 

bfs: Scans big files.bfs(C) 

mail uudecode: decode a binary file for transmission via . . uuencode(C) 

mail uuencode: encode a binary file for transmission via . . uuencode(C) 

fixhdr: Changes executable binary file headers.fixhdr(C) 

selected parts of executable binary files, hdr: Displays .... hdr(CP) 

fread, fwrite: Performs buffered binary input and output.fread(S) 

bsearch: Performs a binary search.bsearch(S) 

tfind, tdelete, twalk: Manages binary search trees, tsearch, . . . tsearch(S) 

Creates an instance of a binary semaphore, creatsem: . . . creatsem(S) 

Removes symbols and relocation bits, strip: .strip(CP) 

rmb: remove extra blank lines from a file.rmb(M) 

shutdn: Flushes block I/O and halts the CPU. . . . shutdn(S) 

cmchk: Reports hard disk block size.cmchk(C) 

df: Report number of free disk blocks.df(C) 

Calculates checksum and counts blocks in a file, sum:.sum(C) 

accepts a number of 512-byte blocks.. . login(M) 

fdswap: Swaps default boot floppy drive.fdswap(ADM) 

boot: XENIX boot program.boot(HW) 

boot: XENIX boot program. . . . boot(HW) 

autoboot: Automatically boots the system.autoboot(ADM) 

initialization procedures bre: bre, bcheckrc - system .brc(ADM) 

initialization procedures bre: bre, bcheckrc - system .... brc(ADM) 

allocation, sbrk, brk: Changes data segment space . sbrk(S) 

segment, brkctl: Allocates data in a far . . . brkctl(S) 

search, bsearch: Performs a binary .... bsearch(S) 

output, fread, fwrite: Performs buffered binary input and .... fread(S) 

stdio: Performs standard buffered input and output.stdio(S) 

setbuf, setvbuf: Assigns buffering to a stream.setbuf(S) 

flushall: Flushes all output buffers.flushall(DOS) 
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a character to the console buffer, ungetch: Returns .... ungetch(DOS) 
idbuild: build new UNIX system kernel . . idbuild(ADM) 

kernel. link_unix: builds a new UNIX system .... link_unix(ADM) 

mknod: Builds special files.mknod(C) 

database of alias and/ dbmbuild: builds the MMDF hashed .... dbmbuild(ADM) 

inp: Returns a byte.inp(DOS) 

outp: Writes a byte to an output port.outp(DOS) 

movedata: Copies bytes from a specific address. . . . movedata(DOS) 

swab: Swaps bytes.swab(S) 

cc: Invokes the C compiler.cc(CP) 

cflow: Generates C flow graph.cflow(CP) 

cpp: The C language preprocessor.cpp(CP) 

lint: Checks C language usage and syntax. . . lint(CP) 

cxref: Generates C program cross-reference. . . . cxref(CP) 

cb: Beautifies C programs.cb(CP) 

xref: Cross-references C programs.xref(CP) 

xstr: Extracts strings from C programs.xstr(CP) 

an error message file from C source, mkstr: Creates .... mkstr(CP) 

distance, hypot, cabs: Determines Euclidean . . . hypot(S) 

cal: Prints a calendar.cal(C) 

blocks in a file, sum: Calculates checksum and counts . sum(C) 

be: Invokes a calculator.bc(C) 

Invokes an arbitrary precision calculator, dc: .dc(C) 

cal: Prints a calendar.cal(C) 

service, calendar: Invokes a reminder . . . calendar(C) 

bdos: Invokes a DOS system call.bdos(DOS) 

intdos: Invokes a DOS system call.intdos(DOS) 

intdosx: Invokes a DOS system call.intdosx(DOS) 

exit: Terminates the calling process.exit(DOS) 

malloc, free, realloc, calloc: Allocates main memory. . . malloc(S) 

cu: Calls another XENIX system. . . cu(C) 

Data returned by stat system call, stat: .stat(F) 

requests to lineprinter. Ip, cancel: Send/cancel .lp(C) 

lineprinter. Ip cancel: Send/cancel requests to . . lp(C) 

termcap: Terminal capability data base.termcap(M) 

terminfo: terminal capability data base.terminfo(M) 

description into a terminfo/ captoinfo: convert a termcap . . . captoinfo(ADM) 

pnch: file format for card images .pnch(F) 

text editor (variant of ex for casual users) edit:.edit(C) 

files, cat: Concatenates and displays . . cat(C) 

cb: Beautifies C programs.cb(CP) 

cc: Invokes the C compiler. . . . cc(CP) 

cd: Changes working directory. . . cd(C) 

commentary of an SCCS delta, ede: Changes the delta .cdc(CP) 

value, floor,/ floor, fabs, ceil, fmod: Performs absolute . . . floor(S) 

/Performs absolute value, floor, ceiling and remainder functions. . floor(S) 

cflow: Generates C flow graph. . . cflow(CP) 

egets: Gets a string.cgets(DOS) 

delta: Makes a delta (change) to an SCCS file.delta(CP) 

allocation, sbrk, brk: Changes data segment space . . . sbrk(S) 

headers, fixhdr: Changes executable binary file . . fixhdr(C) 
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chgrp: Changes group ID.chgrp(C) 

chmod: Changes mode of a file.chmod(S) 

environment, putenv: Changes or adds value to .... putenv(S) 

chown: Changes owner ID.chown(C) 

nice: Changes priority of a process. . . nice(S) 

command, chroot: Changes root directory for .... chroot(ADM) 

modification dates of/ settime: Changes the access and.settime(ADM) 

of a file or directory, chmod: Changes the access permissions . chmod(C) 
an SCCS delta, ede: Changes the delta commentary of . cdc(CP) 

file, newform: Changes the format of a text . . . newform(C) 

system fsname: Prints or changes the name of a file .... fsname(ADM) 
file, chown: Changes the owner and group of a . chown(S) 
chroot: Changes the root directory. . . . chroot(S) 

chsize: Changes the size of a file.chsize(S) 

chdir: Changes the working directory. . . chdir(S) 

cd: Changes working directory. . . . cd(C) 

list: list processor channel for MMDF .list(ADM) 

process NIC database into channel/domain tables nictable: . nictable(ADM) 

xtproto: multiplexed channels protocol used by/ .... xtproto(M) 

stream, ungetc: Pushes character back into input .... ungetc(S) 

isatty: Checks for a character device.isatty(DOS) 

ioctl: Controls character devices.ioctl(S) 

fgetc, fgetchar: Gets a character from a stream.fgetc(DOS) 

getch: Gets a character.getch(DOS) 

getche: Gets and echoes a character.getche(DOS) 

getc, getchar, fgetc, getw: Gets character or word from a stream. . getc(S) 

/putchar, fputc, putw: Puts a character or word on a stream. . . putc(S) 

ascii: Map of the ASCII character set.ascii(M) 

trehan: Translate character sets.trchan(M) 

fputc, fputchar: Write a character to a stream.fputc(DOS) 

ungetch: Returns a character to the console buffer. . . ungetch(DOS) 

putch: Writes a character to the console.putch(DOS) 

Displays/changes hard disk characteristics, dparam:.dparam(ADM) 

strrev: Reverses the order of characters in a string.strrev(DOS) 

charater. strset: Sets all characters in a string to one . . . strset(DOS) 

ltoa: Converts long integers to characters.ltoa(DOS) 

strlwr: Converts uppercase characters to lowercase.strlwr(DOS) 

strupr: Converts lowercase characters to uppercase.strupr(DOS) 

tr: Translates characters.tr(C) 

ultoa: Converts numbers to characters.ultoa(DOS) 

wc: Counts lines, words and characters.wc(C) 

tolower, toascii: Translates characters, conv, toupper, .... conv(S) 

toascii: Classifies or converts characters, /tolower, toupper, . . ctype(S) 

characters in a string to one charater. strset: Sets all.strset(DOS) 

lastlogin, monacct,/ acctsh: chargefee, ckpacct, dodisk, . . . acctsh(ADM) 

directory, chdir: Changes the working . . . chdir(S) 

non-obviousness, goodpw: Check a password for.goodpw(ADM) 

fstab: File system mount and check commands.fstab(F) 

Authentication database authek: check internal consistency of . . . authck(ADM) 

permissions file uucheck: check the uucp directories and . . uucheck(ADM) 

processed by fsek. checklist: List of file systems . . . checklist(F) 
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Permuted Index 


has been submitted but not/ checkmail: checks for mail which . checkmail(C) 

report generator checkque: MMDF queue status . . checkque(ADM) 

waitsem, nbwaitsem: Awaits and checks access to a resource/ . . . waitsem(S) 

fsck: Checks and repairs file systems. . fsck(ADM) 
syntax, lint: Checks C language usage and . . lint(CP) 

isatty: Checks for a character device. . . isatty(DOS) 

submitted but not/ checkmail: checks for mail which has been . . checkmail(C) 

grpcheck: Checks group file.grpcheck(C) 

pwcheck: Checks password file.pwcheck(C) 

keystroke, kbhit: Checks the console for a .... kbhit(DOS) 
to be read, rdchk: Checks to see if there is data . . . rdchk(S) 

file, sum: Calculates checksum and counts blocks in a . sum(C) 

auditing for the next session chg_audit: enables and disable . . chg_audit(ADM) 

chgrp: Changes group ID.chgrp(C) 

times: Gets process and child process times.times(S) 

terminate, wait: Waits for a child process to stop or.wait(S) 

chmod: Changes mode of a file. . . chmod(S) 

permissions of a file or/ chmod: Changes the access . . . chmod(C) 

chown: Changes owner ID. . . . chown(C) 

group of a file, chown: Changes the owner and . . chown(S) 

for command, chroot: Changes root directory . . chroot(ADM) 

directory, chroot: Changes the root .... chroot(S) 
table chrtbl: create a ctype locale . . . chrtbl(M) 

file, chsize: Changes the size of a ... chsize(S) 

monaccty acctsh: chargefee, ckpacct, dodisk, lastlogin, .... acctsh(ADM) 
tolower, toupper, toascii: Classifies or converts/ /isascii, . . ctype(S) 
in directories specified cleantmp: remove temporary files . cleantmp(ADM) 
STREAMS error logger cleanup program strclean: .... strclean(ADM) 

uuclean: uucp spool directory clean-up.uuclean(ADM) 

clear: Clears a terminal screen. . . clear(C) 

stream status, ferror, feof, clearerr, fileno: Determines . . . ferror(S) 

clear: Clears a terminal screen.clear(C) 

clri: Clears inode.clri(ADM) 

a shell command interpreter with C-like syntax, csh: Invokes . . . csh(C) 

alarm: Sets a process’ alarm clock.alarm(S) 

rtc: real time clock interface .rtc(HW) 

clock: Reports CPU time used. . . clock(S) 

(time of day) clock, clock: The system real-time . . . clock(F) 

system real-time (time of day) clock, clock: The .clock(F) 

gets string from real-time clock getclk: .getclk(M) 

system real-time (time of day) clock, setclock: Sets the .... setclock(ADM) 
operations, closedir: Performs directory . . . directory(S) 

close: Closes a file descriptor.close(S) 

fclose, fflush: Closes or flushes a stream.fclose(S) 

shuts down the/ haltsys, reboot: Closes out the file systems and . . haltsys(ADM) 

fclose, fcloseall: Closes streams.fclose(DOS) 

clri: Clears inode.clri(ADM) 

size, cmchk: Reports hard disk block . . cmchk(C) 

configuration data base, cmos: Displays and sets the ... cmos(HW) 

cmp: Compares two files.cmp(C) 

coflconv: Convert 386 COFF files to XENIX format. . . coflconv(M) 
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Permuted Index 


coltbl: create a 
the audit/ auditd: read audit 
screen: tty [01-a], 
setcolor: Set screen 
locale table 
lc: Lists directory contents in 

comb: 

common to two sorted files. 

nice: Runs a 
segread: 

env: Sets environment for 
quits, nohup: Runs a 
subsystem activation,/ auditcmd: 
rsh: Invokes a restricted shell 
sh: Invokes the shell 
syntax, csh: Invokes a shell 
uux: Executes 
getopt: Parses 
getopts, getoptcvt - parse 
system activity timex: time a 
accounting records acctcms: 
system: Executes a shell 
time: Times a 
Changes root directory for 
at, batch: Executes 
cron: Executes 
micnet: The Micnet default 
help: Asks for help about SCCS 
intro: Introduces XENIX 
system, remote: Executes 
environment rc2: run 
operating system rcO: run 
xargs: Constructs and executes 
File system mount and check 
XENIX Development System 
and miscellaneous accounting 
cdc: Changes the delta 
routines ldfcn: 
scnhdr: section header for a 
format syms: 
line number entries in a 
relocation information for a 
filehdr: file header for 
comm: Selects or rejects lines 
/the status of inter-process 
ftok: Standard interprocess 
descriptions infocmp: 

dircmp: 

sdiffi 


col: Filters reverse linefeeds. . . . 

collation locale table. 

collection files generated by ... 

color, monochrome, ega,. 

color. 

coltbl: create a collation. 

columns. 

comb: Combines SCCS deltas. . . 

Combines SCCS deltas. 

comm: Selects or rejects lines . . 
command at a different priority. . . 

command description. 

command execution. 

command immune to hangups and . 
command interface for audit . . . 

(command interpreter). 

command interpreter. 

command interpreter with C-like 
command on remote XENIX. . . . 

command options. 

command options getopts: . . . . 
command; report process data and . 
command summary from per-process 

command. 

command. 

command, chroot:. 

commands at a later time. 

commands at specified times. . . . 

commands file. 

commands. 

commands. 

commands on a remote XENIX . . 
commands performed for multiuser 
commands performed to stop the 

commands. 

commands, fstab: . 

commands, intro: Introduces . . . 
commands /overview of accounting 
commentary of an SCCS delta. . . 
common object file access .... 

common object file. 

common object file symbol table 
common object file linenum: . . . 
common object file reloc: . . . . 

common object files . 

common to two sorted files. . . . 

communication facilities. 

communication package. 

compare or print out terminfo . . 

Compares directories. 

Compares files side-by-side. . . . 
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col(C) 

coltbl(M) 

auditd(ADM) 

screen(HW) 

setcolor(C) 

coltbl(M) 

lc(C) 

comb(CP) 

comb(CP) 

comm(C) 

nice(C) 

segread(DOS) 

env(C) 

nohup(C) 

auditcmd(ADM) 

rsh(C) 

sh(C) 

csh(C) 

uux(C) 

getopt(C) 

getopts(C) 

timex(ADM) 

acctcms(ADM) 

system(S) 

time(CP) 

chroot(ADM) 

at(C) 

cron(C) 

micnet(F) 

help(CP) 

Intro(C) 

remote(C) 

rc2(ADM) 

rcO(ADM) 

xargs(C) 

fstab(F) 

Intro(CP) 

acct(ADM) 

cdc(CP) 

ldfcn(F) 

scnhdr(F) 

syms(F) 

linenum(F) 

reloc(F) 

filehdr(F) 

comm(C) 

ipcs(ADM) 

stdipc(S) 

infocmp(ADM) 

dircmp(C) 

sdiff(C) 
























Permuted Index 


diff. bdiffi Compares files too large for ... bdifi^C) 

diskcp, diskcmp: Copies or compares floppy disks.diskcp(C) 

difiB: Compares three files.diff3(C) 

cmp: Compares two files.cmp(C) 

diff: Compares two text files.difft^C) 

file, sccsdiffi Compares two versions of an SCCS sccsdifl^CP) 
regexp: Regular expression compile and match routines. . . . regexp(S) 

terminfo: Format of compiled terminfo file.terminfo(F) 

cc: Invokes the C compiler.cc(CP) 

tic: Terminfo compiler.tic(C) 

yacc: Invokes a compiler-compiler.yacc(CP) 

expressions, regex, regcmp: Compiles and executes regular . . regex(S) 

regcmp: Compiles regular expressions. . . regcmp(CP) 

erf, erfc: Error function and complementary error function. . . erf(S) 

processes, wait: Awaits completion of background .... wait(C) 

subsystem: security subsystem component description .subsystem(M) 

storage, compress: Compress data for ... compress(C) 

compress: Compress data for storage.compress(C) 

pack, peat, unpack: Compresses and expands files. . . pack(C) 

scsi: Small computer systems interface. . . . scsi(HW) 

cat: Concatenates and displays files. . . cat(C) 

conditions, test: Tests.test(C) 

system, config: Configures a XENIX . . . config(ADM) 

emos: Displays and sets the configuration data base.cmos(HW) 

update, or get device driver configuration data /add, delete, . . idinstall(ADM) 

hwconfig: Read the configuration information.hwconfig(ADM) 

/mapsem, mapstr, convkey: Configure monitor screen/ .... mapkey(M) 
mapehan: Configure tty device mapping. . . mapchan(M) 

config: Configures a XENIX system. . . . config(ADM) 

spooling system, lpadmin: Configures the lineprinter .... lpadmin(ADM) 
/fwtmp, wtmpfix: manipulate connect accounting records . . . fwtmp(ADM) 

an out-going terminal line connection, dial: Establishes . . . dial(S) 

database authek: check internal consistency of Authentication . . authck(ADM) 

Returns a character to the console buffer, ungetch: .... ungetch(DOS) 

eputs: Puts a string to the console.cputs(DOS) 

console: System console device.console(M) 

kbhit: Checks the console for a keystroke.kbhit(DOS) 

cscanf: Converts and formats console input.cscanf(DOS) 

messages: Description of system console messages.messages(M) 

putch: Writes a character to the console.putch(DOS) 

console: System console device. . console(M) 

to printer attached to a serial console /Print file .consoleprint(ADM) 

printer attached to a serial/ consoleprint: Print file to .... consoleprint(ADM) 

math: math functions and constants.math(M) 

unistd: file header for symbolic constants.unistd(F) 

for implementation-specific constants limits: file header . . . limits(F) 

mkfs: Constructs a file system.mkfs(ADM) 

commands, xargs: Constructs and executes.xargs(C) 

debugging on uutry:tryto contact remote system with . . . uutry(ADM) 

idmkinit: read files containing specifications .... idmkinit(ADM) 
ev_block: Wait until the queue contains an event.ev_block(S) 
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Permuted Index 


lc: Lists directory contents in columns.lc(C) 

Is: Gives information about contents of directories.ls(C) 

1: Lists information about contents of directory.1(C) 

Splits files according to context, csplit: .csplit(C) 

UUCP control files, uuinstall: Administers uuinstall(ADM) 
device tapecntl: AT&T tape control for QIC-24/QIC-02 tape . . tapecntl(C) 

init, inir: Process control initialization.init(M) 

jagent: host control of windowing terminal . . jagent(M) 

msgctl: Provides message control operations.msgctl(S) 

fcntl: file control options .fcntl(M) 

uadmin: administrative control .uadmin(ADM) 

uadmin: administrative control.uadmin(S) 

vc: version control .vc(C) 

ioctl: Controls character devices. . . . ioctl(S) 

fcntl: Controls open files.fcntl(S) 

semctl: Controls semaphore operations. . . semctl(S) 
operations, shmctl: Controls shared memory .... shmctl(S) 

uucp status inquiry and job control, uustat: .uustat(C) 

Translates characters, conv, toupper, tolower, toascii: . . conv(S) 

fcvt, gcvt: Performs output conversions, ecvt,.ecvt(S) 

format, coffconv: Convert 386 COFF files to XENIX coffconv(M) 
into a terminfo/ captoinfo: convert a termcap description . . captoinfo(ADM) 

double-precision/ strtod, atof: Converts a string to a.strtod(S) 

routing file to/ mnlist: converts a XENIX-style Micnet . . mnlist(ADM) 

dd: Converts and copies a file.dd(C) 

input, cscanf: Converts and formats console . . cscanf(DOS) 

scanf, fscanf, sscanf: Converts and formats input. . . . scanf(S) 

libraries, ranlib: Converts archives to random . . . ranlib(CP) 

atof, atoi, atol: Converts ASCII to numbers. . . . atof(S) 

and long/ 13tol, ltol3: Converts between 3-byte integers . 13tol(S) 
and base 64 ASCII. a641,164a: Converts between long integer . . a641(S) 
toupper, toascii: Classifies or converts characters, /tolower, . . ctype(S) 
/gmtime, asctime, tzset: Converts date and time to ASCII. . ctime(S) 
characters, ltoa: Converts long integers to .... ltoa(DOS) 
uppercase, strupr: Converts lowercase characters to . strupr(DOS) 

ultoa: Converts numbers to characters. . ultoa(DOS) 
itoa: Converts numbers to integers. . . itoa(DOS) 
standard FORTRAN, ratfor: Converts Rational FORTRAN into ratfor(CP) 

strtol, atol, atoi: Converts string to integer.strtol(S) 

units: Converts units.units(C) 

lowercase, strlwr: Converts uppercase characters to . strlwr(DOS) 

screen/ mapkey, mapscm, mapstr, convkey: Configure monitor . . . mapkey(M) 

dd: Converts and copies a file.dd(C) 

address, movedata: Copies bytes from a specific . . . movedata(DOS) 

cpio: Copies file archives in and out. . . cpio(C) 

systems, rep: Copies files across XENIX .... rcp(C) 

cp: Copies files.cp(C) 

copy: Copies groups of files.copy(C) 

diskep, diskemp: Copies or compares floppy disks. . diskcp(C) 
copy: Copies groups of files. . . . copy(C) 

volcopy: make literal copy of UNIX file system .... volcopy(ADM) 
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Permuted Index 


for optimal access time dcopy: copy UNIX filesystems .dcopy(ADM) 

Public XENIX-to-XENEX file copy, uuto, uupick: .uuto(C) 

core: Format of core image file. . . core(F) 

core: Format of core image file.core(F) 

asktime: Prompts for the correct time of day.asktime(ADM) 

atan2: Performs/ sin, cos, tan, asin, acos, atan, .... trig(S) 

functions, sinh, cosh, tanh: Performs hyperbolic . . sinh(S) 

sum: Calculates checksum and counts blocks in a file.sum(C) 

characters, wc: Counts lines, words and.wc(C) 

cp: Copies files.cp(C) 

cpio: Format of cpio archive.cpio(F) 

and out. cpio: Copies file archives in ... cpio(C) 
cpio: Format of cpio archive. . . . cpio(F) 

preprocessor, cpp: The C language .cpp(CP) 

cprintf: Formats output.cprintf(DOS) 

clock: Reports CPU time used.clock(S) 

Flushes block I/O and halts the CPU. shutdn:.shutdn(S) 

console, cputs: Puts a string to the .... cputs(DOS) 
crash: examine system images . . crash(ADM) 
rewrites an existing one. creat: Creates a new file or .... creat(S) 

coltbl: create a collation locale table . . . coltbl(M) 

chrtbl: create a ctype locale table .... chrtbl(M) 
curtbl: create a currency locale table . . . curtbl(M) 

mestbl: create a messages locale file ... mestbl(M) 
numtbl: Create a numeric locale table. . . numtbl(M) 

file, tmpnam, tempnam: Creates a name for a temporary . . tmpnam(S) 

mkdir: Creates a new directory.mkdir(DOS) 

an existing one. creat: Creates a new file or rewrites . . . creat(S) 

fork: Creates a new process.fork(S) 

spawnl, spawnvp: Creates a new process.spawn(DOS) 

ctags: Creates a tags file.ctags(CP) 

tee: Creates a tee in a pipe.tee(C) 

tmpfile: Creates a temporary file.tmpfile(S) 

from C source, mkstr: Creates an error message file ... mkstr(CP) 
profile, profil: Creates an execution time .... profil(S) 
semaphore, creatsem: Creates an instance of a binary . . creatsem(S) 
pipe: Creates an interprocess pipe. . . . pipe(S) 

files, admin: Creates and administers SCCS . . admin(CP) 

/Scans fixed disk for flaws and creates bad track table.badtrk(ADM) 

umask: Sets and gets file creation mask.umask(S) 

a binary semaphore, creatsem: Creates an instance of . creatsem(S) 
listing, cref: Makes a cross-reference . . cref(CP) 

atcronsh: Menu driven at and cron administration utility .... atcronsh(ADM) 
specified times, cron: Executes commands at . . . cron(C) 

crontab: user crontab file.crontab(C) 

crontab: user crontab file .... crontab(C) 
intro: Introduction to DOS cross development functions. . . . intro(DOS) 

dosld: XENIX to MS-DOS cross linker.dosld(CP) 

cxref: Generates C program cross-reference.cxref(CP) 

cref: Makes a cross-reference listing.cref(CP) 

xref: Cross-references C programs. . . xref(CP) 
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Permuted Index 


crypt: encode/decode. 

console input, cscanf: Converts and formats . . . 

interpreter with C-like syntax, csh: Invokes a shell command . . 

to context, csplit: Splits files according . . . 

terminal ct: spawn getty to a remote . . . 

ctags: Creates a tags file. 

for a terminal, ctermid: Generates a filename . . 
asctime, tzset: Converts date/ ctime, localtime, gmtime, .... 

islower, isdigit, isxdigit,/ ctype, isalpha, isupper, . 

chrtbl: create a ctype locale table . 

cu: Calls another XENIX system. . 

curtbl: create a currency locale table. 

ev_getemask: Return the current event mask. 

rename login entry to show current layer relogin:. 

pointer, tell: Gets the current position of the file . . . . 

activity, sact: Prints current SCCS file editing . . . . 

the slot in the utmp file of the current user, ttyslot: Finds . . . . 

getcwd: Get the pathname of current working directory. 

uname: Prints the name of the current XENIX system. 

uname: Gets name of current XENIX system. 

/Returns the number of events currently in the queue. 

ev_flush: Discard all events currently in the queue. 

/the list of major device numbers currently specified in the/ . . . . 

/displays the list of vectors currently specified in the/ . . . . 

cursor functions, curses: Performs screen and . . . 

scr_dump: format of curses screen image file. 

curses: Performs screen and cursor functions. 

table curtbl: create a currency locale . . 

spline: Interpolates smooth curve. 

the user, cuserid: Gets the login name of . . 
each line of a file, cut: Cuts out selected fields of . . 

line of a file, cut: Cuts out selected fields of each . . 

cross-reference, cxref: Generates C program . . . 

daemon.mn: Micnet mailer daemon. 

daemon.mn: Micnet mailer daemon. 

STREAMS error logger daemon strerr: . 

runacct: run daily accounting. 

sdwaitv: Synchronizes shared data access, sdgetv, . 

reduce: perform audit data analysis and reduction . . . 

time a command; report process data and system activity timex: . . 

termcap: Terminal capability data base. 

terminfo: terminal capability data base.. . . 

and sets the configuration data base, cmos: Displays . . . . 

generate disk accounting data by user ID diskusg: . . . . 

compress: Compress data for storage. 

brkctl: Allocates data in a far segment. 

/sgetl: Accesses long integer data in a machine-independent. . . 

plock: Lock process, text, or data in memory. 

prof: Displays profile data. 

execseg: makes a data region executable. 

call, stat: Data returned by stat system . . . 


crypt(C) 

cscanf(DOS) 

csh(C) 

csplit(C) 

ct(C) 

ctags(CP) 

ctermid(S) 

ctime(S) 

ctype(S) 

chrtbl(M) 

cu(C) 

curtbl(M) 

ev_gtemsk(S) 

relogin(ADM) 

tell(DOS) 

sact(CP) 

ttyslot(S) 

getcwd(S) 

uname(C) 

uname(S) 

ev_count(S) 

ev_flush(S) 

majorsinuse(ADM) 

vectorsinuse(ADM) 

curses(S) 

scr_dump(F) 

curses(S) 

curtbl(M) 

spline(CP) 

cuserid(S) 

cut(C) 

cut(C) 

cxref(CP) 

daemon.mn(M) 

daemon.mn(M) 

strerr(ADM) 

runacct(ADM) 

sdgetv(S) 

reduce(ADM) 

timex(ADM) 

termcap(M) 

terminfo(M) 

cmos(HW) 

diskusg(ADM) 

compress(C) 

brkctl(S) 

sputl(S) 

plock(S) 

prof(CP) 

execseg(S) 

stat(F) 
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Permuted Index 


sbrk, brk: Changes data segment space allocation. . . sbrk(S) 

Synchronizes access to a shared data segment, sdenter, sdleave: . . sdenter(S) 

Attaches and detaches a shared data segment, sdget, sdfree: . . . sdget(S) 

rdchk: Checks to see if there is data to be read.rdchk(S) 

types: Primitive system data types.types(F) 

get device driver configuration data /add, delete, update, or ... idinstall(ADM) 

authcap: authentication database.authcap(ADM) 

backups schedule: Database for automated system . . schedule(ADM) 

firstkey, nextkey: Performs database functions, /delete, . . . dbm(S) 

tables nictable: process NIC database into channel/domain . . nictable(ADM) 

terminfo: terminal description database.terminfo(S) 

tput: Queries the terminfo database.tput(C) 

consistency of Authentication database authck: check internal . authck(ADM) 

files against authentication database /examine system .... integrity(ADM) 

/gmtime, asctime, tzset: Converts date and time to ASCII.ctime(S) 

date: Prints and sets the date.date(C) 

date: Prints and sets the date. . . . date(C) 

time, ftime: Gets time and date.time(S) 

the access and modification dates of files. /Changes.settime(ADM) 

sddate: Prints and sets backup dates.sddate(C) 

strftime: format date/time string .strftime(S) 

The system real-time (time of day) clock, clock: .clock(F) 

the system real-time (time of day) clock, setclock: Sets .... setclock(ADM) 

Prompts for the correct time of day. asktime:.asktime(ADM) 

MMDF hashed database of/ dbmbuild: builds the .dbmbuild(ADM) 

firstkey, nextkey: Performs/ dbminit, fetch, store, delete, . . . dbm(S) 

precision calculator, dc: Invokes an arbitrary.dc(C) 

filesystems for optimal access/ dcopy: copy UNIX.dcopy(ADM) 

dd: Converts and copies a file. . . dd(C) 
devices, assign, deassign: Assigns and deassigns . assign(C) 

assign, deassign: Assigns and deassigns devices.assign(C) 

adb: Invokes a general-purpose debugger.adb(CP) 

fsdb: File system debugger.fsdb(ADM) 

sdb: Invokes symbolic debugger.sdb(CP) 

to contact remote system with debugging on uutry: try.uutry(ADM) 

transmission via mail uudecode: decode a binary file for .uuencode(C) 

fdswap: Swaps default boot floppy drive.fdswap(ADM) 

micnet: The Micnet default commands file.micnet(F) 

information directory, default: Default program .... default(F) 

defopen, deffead: Reads default entries.defopen(S) 


directory, default: Default program information . . . default(F) 

timezone: set default system time zone .... timezone(F) 

entries, defopen, deffead: Reads default . . defopen(S) 

defopen, deffead: Reads default entries. . . defopen(S) 


Performs/ dbminit, fetch, store, delete, firstkey, nextkey: .... dbm(S) 

driver/ idinstall: add, delete, update, or get device . . . idinstall(ADM) 
rmdir: Deletes a directory.rmdir(DOS) 


process deliver: MMDF mail delivery . . deliver(ADM) 
which has been submitted but not delivered /checks for mail .... checkmail(C) 
pathname, dimame: Delivers directory part of .... dimame(C) 
file, tail: Delivers the last part of a .... tail(C) 
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Permuted Index 


deliver: MMDF mail delivery process. 

delta: Makes a delta (change) to an SCCS file. . . 
delta, cdc: Changes the delta commentary of an SCCS . . 

rmdel: Removes a delta from an SCCS file. 

an SCCS file, delta: Makes a delta (change) to 

the delta commentary of an SCCS delta, cdc: Changes . 

comb: Combines SCCS deltas. 

terminal, mesg: Permits or denies messages sent to a .... 

terminfo: terminal description database. 

captoinfo: convert a termcap description into a terminfo/ . . . 

Machine: Description of host machine. . . . 
messages, messages: Description of system console . . 

segread: command description. 

description into a terminfo description /convert a termcap . . 

compare or print out terminfo descriptions infocmp: . 

security subsystem component description subsystem: . 

close: Closes a file descriptor. 

dup2: Duplicates an open file descriptor, dup,. 

sdget, sdfree: Attaches and detaches a shared data segment. 

fstyp: determine file system identifier . . 
file, access: Determines accessibility of a ... 

dtype: Determines disk type. 

eof: Determines end-of-file. 

hypot, cabs: Determines Euclidean distance. . . 

file: Determines file type. 

ferror, feof, clearerr, fileno: Determines stream status. 

whodo: Determines who is doing what. . . 

audit: audit subsystem interface device. 

console: System console device. 

/add, delete, update, or get device driver configuration data . . 

error: Kernel error output device. 

/Default backup device information. 

Ip, lpO, lpl, lp2: Line printer device interfaces. 

isatty: Checks for a character device. 

mapchan: Format of tty device mapping files. 

mapchan: Configure tty device mapping. 

devnm: Identifies device name. 

/displays the list of major device numbers currently/ . . . . 

systty: System maintenance device. 

ev_getdev: Gets a list of devices feeding an event queue. 

devices: Format of UUCP devices file. 

ev_gindev: include/exclude devices for event input. 

file, devices: Format of UUCP devices . 

ioctl: Controls character devices. 

deassign: Assigns and deassigns devices, assign,. 

event queue and all associated devices. ev_close: Close the . . . 
control for QIC-24/QIC-02 tape device tapecntl: AT&T tape . . . 

font and video mode for a video device, vidi: Sets the. 

devnm: Identifies device name. . . 
blocks, df: Report number of free disk . . 
dial: Dials a modem. 


deliver(ADM) 

delta(CP) 

cdc(CP) 

rmdel(CP) 

delta(CP) 

cdc(CP) 

comb(CP) 

mesg(C) 

terminfo(S) 

captoinfo(ADM) 

machine(HW) 

messages(M) 

segread(DOS) 

captoinfo(ADM) 

infocmp(ADM) 

subsystem(M) 

close(S) 

dup(S) 

sdget(S) 

fstyp(ADM) 

access(S) 

dtype(C) 

eof(DOS) 

hypot(S) 

file(C) 

ferror(S) 

whodo(C) 

audit(ADM) 

console(M) 

idinstall(ADM) 

error(M) 

archive(F) 

lp(HW) 

isatty(DOS) 

mapchan(F) 

mapchan(M) 

devnm(C) 

majorsinuse(ADM) 

systty(M) 

ev_getdev(S) 

devices(F) 

ev_gindev(S) 

devices(F) 

ioctl(S) 

assign(C) 

ev_close(S) 

tapecntl(C) 

vidi(C) 

devnm(C) 

df(C) 

dial(ADM) 
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terminal line connection, dial: Establishes an out-going . . dial(S) 

dialcodes: Format of UUCP dial-code abbreviations file. . . . dialcodes(F) 

dial-code abbreviations file, dialcodes: Format of UUCP . . . dialcodes(F) 

dialers: Format of UUCP Dialers file.dialers(F) 

file, dialers: Format of UUCP Dialers . dialers(F) 

dial: Dials a modem.dial(ADM) 

uuchat: dials a modem.dial(ADM) 

passwd: Change login, group, or dialup shell password.passwd(C) 

diffi Compares two text files. . . . difl(C) 

difB: Compares three files. . . . difB(C) 

dir: Format of a directory.dir(F) 

dircmp: Compares directories. . . dircmp(C) 

uucheck: check the uucp directories and permissions file . . uucheck(ADM) 

dircmp: Compares directories.dircmp(C) 

mv: Moves or renames files and directories.mv(C) 

rm, rmdir: Removes files or directories.rm(C) 

rmdir: Removes directories.rmdir(C) 

remove temporary files in directories specified cleantmp: . . cleantmp(ADM) 

link and unlink files and directories link: link, unlink: . . . link(ADM) 

information about contents of directories. Is: Gives.ls(C) 

cd: Changes working directory.cd(C) 

chdir: Changes the working directory.chdir(S) 

chroot: Changes the root directory.chroot(S) 

uuclean: uucp spool directory clean-up .uuclean(ADM) 

lc: Lists directory contents in columns. . . lc(C) 

dir: Format of a directory.dir(F) 

file, getdents: read directory entries and put in a ... getdents(S) 

dirent: file system independent directory entry.dirent(F) 

dirent: file-system-independent directory entry .dirent(F) 

unlink: Removes directory entry.unlink(S) 

chroot: Changes root directory for command.chroot(ADM) 

uucico: Scan the spool directory for work.uucico(C) 

mkdir: Makes a directory.mkdir(C) 

mkdir: Creates a new directory.mkdir(DOS) 

mvdir: Moves a directory.mvdir(C) 

pwd: Prints working directory name.pwd(C) 

basename: Removes directory names from pathnames. . basename(C) 

closedir: Performs directory operations.directory(S) 

ordinary file, mknod: Makes a directory, or a special or.mknod(S) 

dimame: Delivers directory part of pathname. . . . dimame(C) 

rename: renames a file or directory.rename(DOS) 

rmdir: Deletes a directory.rmdir(DOS) 

access permissions of a file or directory, chmod: Changes the . . chmod(C) 

Default program information directory, default:.default(F) 

the pathname of current working directory, getcwd: Get .getcwd(S) 

information about contents of directory. 1: Lists .1(C) 

directory entry, dirent: file system independent . . dirent(F) 

directory entry dirent: file-system-independent . . dirent(F) 

of pathname, dimame: Delivers directory part . dimame(C) 

session chg_audit: enables and disable auditing for the next . . . chg_audit(ADM) 

printers, disable: Turns off terminals and . . disable(C) 
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Permuted Index 


acct: Enables or disables process accounting. . . . acct(S) 

the queue. ev_flush: Discard all events currently in . . ev_flush(S) 

type, modes, speed, and line discipline /set terminal.uugetty(ADM) 

type, modes, speed, and line discipline. /Sets terminal .... getty(M) 

diskusg: generate disk accounting data by user ID . . diskusg(ADM) 

cmchk: Reports hard disk block size.cmchk(C) 

df: Report number of free disk blocks.df(C) 

dparam: Displays/changes hard disk characteristics.dparam(ADM) 

hd: Internal hard disk drive.hd(HW) 

track/ badtrk: Scans fixed disk for flaws and creates bad . . badtrk(ADM) 

fdisk: Maintain disk partitions.fdisk(ADM) 

dtype: Determines disk type.dtype(C) 

du: Summarizes disk usage.du(C) 

floppy disks, diskcp, diskcmp: Copies or compares . . diskcp(C) 

compares floppy disks, diskcp, diskcmp: Copies or ... diskcp(C) 

format: format floppy disks.format(C) 

Copies or compares floppy disks, diskcp, diskcmp:.diskcp(C) 

accounting data by user ID diskusg: generate disk .diskusg(ADM) 

umount: Dismounts a file structure.umount(ADM) 

zcat: Display a stored file.compress(C) 

vedit: Invokes a screen-oriented display editor, vi, view,.vi(C) 

displaypkg: display installed packages .... displaypkg(ADM) 

packages displaypkg: display installed . . . displaypkg(ADM) 

configuration data base, cmos: Displays and sets the.cmos(HW) 

cat: Concatenates and displays files.cat(C) 

format, hd: Displays files in hexadecimal . . . hd(C) 

od: Displays files in octal format. . . . od(C) 

system activity, uptime: Displays information about . . . uptime(C) 

is on the system and what w: Displays information about who . w(C) 

prof: Displays profile data.prof(CP) 

executable binary files, hdr: Displays selected parts of .... hdr(CP) 
device numbers/ majorsinuse: displays the list of major .... majorsinuse(ADM) 
currently/ vectorsinuse: displays the list of vectors .... vectorsinuse(ADM) 
characteristics, dparam: Displays/changes hard disk . . . dparam(ADM) 

mail: Sends, reads or disposes of mail.mail(C) 

cabs: Determines Euclidean distance, hypot,.hypot(S) 

lcong48: Generates uniformly distributed. srand48, seed48, . . . drand48(S) 

divvy -b block_device -c c/ . . divvy(ADM) 
records for subsystem events dlvr_audit: produce audit .... dlvr_audit(ADM) 
acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct,/ . . . acctsh(ADM) 

whodo: Determines who is doing what.whodo(C) 

promain: restrict the execution domain of a program.promain(M) 

intro: Introduction to DOS cross development functions. intro(DOS) 

dosexterr: Gets DOS error messages.dosexter(DOS) 

dosls, dosrm, dosrmdir: Access DOS files.dos(C) 

bdos: Invokes a DOS system call.bdos(DOS) 

intdos: Invokes a DOS system call.intdos(DOS) 

intdosx: Invokes a DOS system call.intdosx(DOS) 

messages, dosexterr: Gets DOS error .... dosexter(DOS) 

linker, dosld: XENIX to MS-DOS cross . dosld(CP) 

DOS files, dosls, dosrm, dosrmdir: Access . . dos(C) 
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Permuted Index 


files, dosls, dosrm, dosrmdir: Access DOS . . dos(C) 

dosls, dosrm, dosrmdir: Access DOS files. . . . dos(C) 

/atof: Converts a string to a double-precision number.strtod(S) 

DMD/ wtinit: object downloader for the 5620 .... wtinit(ADM) 

disk characteristics, dparam: Displays/changes hard . . dparam(ADM) 

graph: draw a graph .graph(ADM) 

hd: Internal hard disk drive.hd(HW) 

Swaps default boot floppy drive, fdswap: .fdswap(ADM) 

administration/ atcronsh: Menu driven at and cron .atcronsh(ADM) 

utility auditsh: Menu driven audit administration . . . auditsh(ADM) 

utility backupsh: Menu driven backup administration . . . backupsh(ADM) 

administration/ lpsh: Menu driven lp print service .lpsh(ADM) 

utility, sysadmsh: Menu driven system administration . . . sysadmsh(ADM) 

delete, update, or get device driver configuration data /add, . . idinstall(ADM) 

object module, routines: finds driver entry points in a driver . . . routines(ADM) 

terminals xt: multiplexed tty driver for AT&T windowing . . . xt(HW) 

finds driver entry points in a driver object module, routines: . . routines(ADM) 

xtt: extract and print xt driver packet traces .xtt(ADM) 

xts: extract and print xt driver statistics .xts(ADM) 

sxt: Pseudo-device driver.sxt(M) 

protocol used by x t (7) driver /multiplexed channels . . . xtproto(M) 

term: Terminal driving tables for nroff. .term(F) 

dtype: Determines disk type. . . . dtype(C) 

du: Summarizes disk usage. . . . du(C) 

backup: Incremental dump tape format.backup(F) 

files on a backup archive, dumpdir: Prints the names of . . . dumpdir(C) 

file, tapedump: Dumps magnetic tape to output . . tapedump(C) 

file descriptor, dup, dup2: Duplicates an open . . dup(S) 

descriptor, dup, dup2: Duplicates an open file . . . dup(S) 

descriptor, dup, dup2: Duplicates an open file .dup(S) 

echo: Echoes arguments.echo(C) 

getche: Gets and echoes a character.getche(DOS) 

echo: Echoes arguments.echo(C) 

output conversions, ecvt, fcvt, gcvt: Performs .... ecvt(S) 

ed: Invokes the text editor.ed(C) 

program, end, etext, edata: Last locations in .end(S) 

for casual users) edit: text editor (variant of ex ... edit(C) 

sact: Prints current SCCS file editing activity.sact(CP) 

ed: Invokes the text editor.ed(C) 

ex: Invokes a text editor.ex(C) 

Id: Invokes the link editor.ld(CP) 

Id: Invokes the link editor.ld(M) 

Format of assembler and link editor output. a.out: .a.out(F) 

the stream editor, sed: Invokes .sed(C) 

users) edit: text editor (variant of ex for casual . . edit(C) 

a screen-oriented display editor, /view, vedit: Invokes . . . vi(C) 

effective user, real group, and effective group IDs. /real user, . . getuid(S) 

/getgid, getegid: Gets real user, effective user, real group, and/ . . getuid(S) 

color, monochrome, ega,. /tty[01-«],.screen(HW) 

for a pattern, grep, egrep, fgrep: Searches a file ... grep(C) 

i286emul: emulate 80286 .i286emul(C) 
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x286emul: emulate XENIX 80286 .x286emul(C) 

line printers, enable: Hims on terminals and . . enable(C) 

the next session chg_audit: enables and disable auditing for . . chg_audit(ADM) 

accounting, acct: Enables or disables process . . . acct(S) 

transmission via mail uuencode: encode a binary file for .uuencode(C) 

crypt: encode/decode .crypt(C) 

makekey: Generates an encryption key.makekey(M) 

locations in program, end, etext, edata: Last.end(S) 

/getgrgid, getgmam, setgrent, endgrent: Get group file entry. . . getgrent(S) 

eof: Determines end-of-file.eof(DOS) 

/getpwuid, getpwnam, setpwent, endpwent: Gets password file/ . . getpwent(S) 

utmp file entry, endutent, utmpname: Accesses . . getut(S) 

submit: MMDF mail enqueuer.submit(ADM) 

getdents: read directory entries and put in a file.getdents(S) 

defopen, deffead: Reads default entries.defopen(S) 

xlist, fxlist: Gets name list entries from files.xlist(S) 

nlist: Gets entries from name list.nlist(S) 

linenum: line number entries in a common object file . . linenum(F) 

wtmp: Formats of utmp and wtmp entries, utmp,.utmp(F) 

module, routines: finds driver entry points in a driver object . . routines(ADM) 

putpwent: Writes a password file entry.putpwent(S) 

relogin: rename login entry to show current layer .... relogin(ADM) 

unlink: Removes directory entry.unlink(S) 

system independent directory entry, dirent: file .dirent(F) 

utmpname: Accesses utmp file entry, endutent,.getut(S) 

directory entry /file-system-independent . . dirent(F) 
endgrent: Get group file entry, /getgmam, setgrent, .... getgrent(S) 
endpwent: Gets password file entry, /getpwnam, setpwent, . . . getpwent(S) 

command execution, env: Sets environment for .... env(C) 

environ: The user environment. . . environ(M) 

profile: Sets up an environment at login time.profile(M) 

environ: The user environment.environ(M) 

execution, env: Sets environment for command .... env(C) 

getenv: Gets value for environment name.getenv(S) 

putenv: Changes or adds value to environment.putenv(S) 

TZ: Time zone environment variable.tz(M) 

commands performed for multiuser environment rc2: run.rc2(ADM) 

Set or read international environment setlocale: .setlocale(S) 

eof: Determines end-of-file. . . . eof(DOS) 

complementary error function, erf, erfc: Error function and . . . erf(S) 

complementary error/ erf, erfc: Error function and.erf(S) 

perror, sys_errlist, sys_nerr, ermo: Sends system error/ .... perror(S) 

error function, erf, erfc: Error function and complementary erf(S) 

Error function and complementary error function, erf, erfc:.erf(S) 

device, error: Kernel error output .... error(M) 
strclean: STREAMS error logger cleanup program . . . strclean(ADM) 

strerr: STREAMS error logger daemon .strerr(ADM) 

source, mkstr: Creates an error message file from C .... mkstr(CP) 

dosexterr: Gets DOS error messages.dosexter(DOS) 

sys_nerr, ermo: Sends system error messages. /sys_errlist, . . . perror(S) 

services, library routines and error numbers, /system.Intro(S) 
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error: Kernel error output device. .error(M) 

fsave: Interactive, error-checking filesystem backup . fsave(ADM) 

matherr: Error-handling function.matherr(S) 

hashcheck: Finds spelling errors, /hashmake, spellin, .... spell(C) 
terminal line connection, dial: Establishes an out-going .... dial(S) 

setmnt: Establishes/etc/mnttab table. . . . setmnt(ADM) 

setmnt: Establishes /etc/mnttab table.setmnt(ADM) 

program, end, etext, edata: Last locations in . . . end(S) 

hypot, cabs: Determines Euclidean distance.hypot(S) 

expression, expr: Evaluates arguments as an .... expr(C) 

contains an event. ev_block: Wait until the queue . . ev_block(S) 

and all associated devices. ev_close: Close the event queue . ev_close(S) 

events currently in the queue. ev_count: Returns the number of . ev_count(S) 

ev_read: Read the next event in the queue.ev_read(S) 

include/exclude devices for event input. ev_gindev:.ev_gindev(S) 

evjnit: Invokes the event manager.ev_init(S) 

ev_getemask: Return the current event mask.ev_gtemsk(S) 

ev_setemask: Sets event mask.ev_stemsk(S) 

ev_pop: Pop the next event off the queue.ev_pop(S) 

devices. ev_close: Close the event queue and all associated . . ev_close(S) 

ev_suspend: Suspends an event queue.ev_susp(S) 

ev_open: Opens an event queue for input.ev_open(S) 

a list of devices feeding an event queue. ev_getdev: Gets . . ev_getdev(S) 

Wait until the queue contains an event. ev_block: .ev_block(S) 

ev_count: Returns the number of events currently in the queue. . . ev_count(S) 

ev_flush: Discard all events currently in the queue. . . ev_flush(S) 

audit records for subsystem events dlvr_audit: produce . . . dlvr_audit(ADM) 

currently in the queue. ev_flush: Discard all events . . . ev_flush(S) 

devices feeding an event queue. ev_getdev: Gets a list of.ev__getdev(S) 

event mask. ev_getemask: Return the current . ev_gtemsk(S) 

devices for event input. ev_gindev: include/exclude . . . ev_gindev(S) 

manager. ev_init: Invokes the event .... ev_init(S) 

for input. ev_open: Opens an event queue . . ev_open(S) 

the queue. ev_pop: Pop the next event off . . ev_pop(S) 

the queue. ev_read: Read the next event in . . ev_read(S) 

queue. ev_resume: Restart a suspended . ev_resume(S) 
ev_setemask: Sets event mask. . . ev_stemsk(S) 

queue. ev_suspend: Suspends an event . . ev_susp(S) 

edit: text editor (variant of ex for casual users).edit(C) 

ex: Invokes a text editor.ex(C) 

authentication/ integrity: examine system files against . . . integrity(ADM) 

crash: examine system images.crash(ADM) 

pax: portable archive exchange .pax(C) 

execlp, execvp: Executes a/ execl, execv, execle, execve, . . . exec(S) 

Executes a file, execl, execv, execle, execve, execlp, execvp: . . exec(S) 

execl, execv, execle, execve, execlp, execvp: Executes a file. . . exec(S) 

executable, execseg: makes a data region . . . execseg(S) 

fixhdr: Changes executable binary file headers. . . fixhdr(C) 

hdr: Displays selected parts of executable binary files.hdr(CP) 

execseg: makes a data region executable.execseg(S) 

execle, execve, execlp, execvp: Executes a file, execl, execv, . . exec(S) 
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system: 
int86: 
int86x: 
XENIX, uux: 
time, at, batch: 
times, cron: 
XENIX system, remote: 
xargs: Constructs and 
regex, regcmp: Compiles and 
promain: restrict the 
nap: Suspends 
sleep: Suspends 
sleep: Suspends 
monitor: Prepares 
profil: Creates an 
Sets environment for command 
execvp: Executes a file, execl, 
a file, execl, execv, execle, 
execv, execle, execve, execlp, 
link: Links a new filename to an 
a new file or rewrites an 
process. 

exit, 

process. 

false: Returns with a nonzero 
true: Returns with a zero 
Performs exponential,/ 
peat, unpack: Compresses and 
/log, pow, sqrt, log 10: Performs 
number into a mantissa and an 
expression, 
routines, regexp: Regular 
expr: Evaluates arguments as an 
regcmp: Compiles regular 
Compiles and executes regular 
rmb: remove 
statistics xts: 
packet traces xtt: 
programs, xstr: 
absolute value, floor,/ floor, 
of inter-process communication 
factor: 

exit value, 
abort: Generates an IOT 
currently specified in the 
streams, 
flushes a stream. 

fclose. 


Executes a shell command. 

Executes an interrupt. 

Executes an interrupt. 

Executes command on remote 
Executes commands at a later 
Executes commands at specified 
Executes commands on a remote 

executes commands. 

executes regular expressions. . 
execution domain of a program 
execution for a short interval, 
execution for an interval. . . 
execution for an interval. . . 

execution profile. 

execution time profile. . . . 

execution, env: . 

execv, execle, execve, execlp, 
execve, execlp, execvp: Executes 
execvp: Executes a file, execl, 

existing file. 

existing one. creat: Creates 
exit, _exit: Terminates a . . . 
_exit: Terminates a process, 
exit: Terminates the calling 

exit value. 

exit value. 

exp, log, pow, sqrt, log 10: . . 

expands files, pack, .... 
exponential, logarithm, power,/ 
exponent. /Splits floating-point 
expr: Evaluates arguments as an 
expression compile and match 

expression. 

expressions. 

expressions, regex, regcmp: 
extra blank lines from a file 
extract and print xt driver . . 
extract and print xt driver . . 
Extracts strings from C ... 
fabs, ceil, fmod: Performs . . 
facilities. /Reports the status . 

Factor a number. 

factor: Factor a number. . . . 
false: Returns with a nonzero . 

fault. 

s d e v i c e file /of vectors 
fclose, fcloseall: Closes . . . 
fclose, fflush: Closes or ... 
fcloseall: Closes streams. . . 
fcntl: Controls open files. . . 
fcntl: file control options . . 


system(S) 
int86(DOS) 
int86x(DOS) 
uux(C) 
at(C) 
cron(C) 
remote(C) 
xargs(C) 
regex(S) 
promain(M) 
nap(S) 
sleep(C) 
sleep(S) 
monitor(S) 
profil(S) 
env(C) 
exec(S) 
exec(S) 
exec(S) 
link(S) 
creat(S) 
exit(S) 
exit(S) 
exit(DOS) 
false(C) 
true(C) 
exp(S) 
pack(C) 
exp(S) 
frexp(S) 
expr(C) 
regexp(S) 
expr(C) 
regcmp(CP) 
regex(S) 
rmb(M) 
xts(ADM) 
xtt(ADM) 
xstr(CP) 
floor(S) 
ipcs(ADM) 
factor(C) 
factor(C) 
false(C) 
abort(S) 
vectorsinuse(AEP 
fclose(DOS) 
fclose(S) 
fclose(DOS) 
fcntl(S) 
fcntl(M) 
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conversions, ecvt, fcvt, gcvt: Performs output .... ecvt(S) 

fdisk: Maintain disk partitions. . . fdisk(ADM) 

fopen, freopen, fdopen: Opens a stream.fopen(S) 

floppy drive, fdswap: Swaps default boot . . . fdswap(ADM) 

/to machine related miscellaneous features and files.Intro(HW) 

Introduction to miscellaneous features and files, intro:.Intro(M) 

/Gets a list of devices feeding an event queue.ev_getdev(S) 

Determines stream/ ferror, feof, clearerr, fileno: .ferror(S) 

Determines stream status, ferror, feof, clearerr, fileno: . . . ferror(S) 

nextkey: Performs/ dbminit, fetch, store, delete, firstkey, . . . dbm(S) 

stream, fclose, fflush: Closes or flushes a .... fclose(S) 

character from a stream, fgetc, fgetchar: Gets a .fgetc(DOS) 

word from a/ getc, getchar, fgetc, getw: Gets character or . . getc(S) 

a stream, fgetc, fgetchar: Gets a character fiom . . fgetc(DOS) 
stream, gets, fgets: Gets a string from a .... gets(S) 
pattern, grep, egrep, fgrep: Searches a file for a .... grep(C) 

Compares files too large for diff. bdifif .bdifl(C) 

cut: Cuts out selected fields of each line of a file.cut(C) 

of file systems processed by fsck. checklist: List .checklist(F) 

times, utime: Sets file access and modification . . . utime(S) 

ldfcn: common object file access routines.ldfcn(F) 

cpio: Copies file archives in and out.cpio(C) 

chmod: Changes mode of a file.chmod(S) 

chsize: Changes the size of a file.chsize(S) 

uncompress: Uncompress a stored file.compress(C) 

zcat: Display a stored file.compress(C) 

fcntl: file control options.fcntl(M) 

uupick: Public XENIX-to-XENIX file copy, uuto, .uuto(C) 

core: Format of core image file.core(F) 

umask: Sets and gets file creation mask.umask(S) 

crontab: user crontab file .crontab(C) 

ctags: Creates a tags file.ctags(CP) 

dd: Converts and copies a file.dd(C) 

close: Closes a file descriptor.close(S) 

dup, dup2: Duplicates an open file descriptor.dup(S) 

file: Determines file type.file(C) 

devices: Format of UUCP devices file.devices(F) 

dialers: Format of UUCP Dialers file.dialers(F) 

sact: Prints current SCCS file editing activity.sact(CP) 

putpwent: Writes a password file entry.putpwent(S) 

utmpname: Accesses utmp file entry, endutent, .getut(S) 

setgrent, endgrent: Get group file entry, /getgrgid, getgmam, . . getgrent(S) 

endpwent: Gets password file entry, /getpwnam, setpwent, . getpwent(S) 

filelength: Gets the length of a file.fileleng(DOS) 

grep, egrep, fgrep: Searches a file for a pattern.grep(C) 

proto: prototype job file for at.proto(ADM) 

open: Opens file for reading or writing.open(S) 

writing, sopen: Opens a file for shared reading and .... sopen(DOS) 

uudecode: decode a binary file for transmission via mail . . . uuencode(C) 

uuencode: encode a binary file for transmission via mail . . . uuencode(C) 

ar: Archive file format.ar(F) 
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pnch: file format for card images .... pnch(F) 

mdevice: file format.mdevice(F) 

mfsys: file format.mfsys(F) 

mtune: file format.mtune(F) 

sdevice: file format.sdevice(F) 

sfsys: file format.. sfsys(F) 

stune: file format.stune(F) 

intro: Introduction to file formats.Intro(F) 

mkstr: Creates an error message file from C source.mkstr(CP) 

group: Format of the group file.group(M) 

grpcheck: Checks group file.grpcheck(C) 

files filehdr: file header for common object . . filehdr(F) 

implementation-specific/ limits: file header for.limits(F) 

constants unistd: file header for symbolic.unistd(F) 

Changes executable binary file headers, fixhdr: .fixhdr(C) 

split: Splits a file into pieces.split(C) 

issue: issue identification file .issue(F) 

In: Makes a link to a file.ln(C) 

mem, kmem: Memory image file.mem(M) 

mestbl: create a messages locale file .mestbl(M) 

nl: Adds line numbers to a file.nl(C) 

null: The null file.null(F) 

/Finds the slot in the utmp file of the current user.ttyslot(S) 

purge(C) purge: the policy file of the sanitization utility . . . purge(F) 

rename: renames a file or directory.rename(DOS) 

the access permissions of a file or directory. /Changes .... chmod(C) 

one. creat: Creates a new file or rewrites an existing .... creat(S) 

passwd: The password file.passwd(F) 

/ftell, rewind: Repositions a file pointer in a stream.fseek(S) 

lseek: Moves read/write file pointer.lseek(S) 

Gets the current position of the file pointer, tell:.tell(DOS) 

poll: Format of UUCP Poll file.poll(F) 

prs: Prints an SCCS file.prs(CP) 

pwcheck: Checks password file.pwcheck(C) 

read: Reads from a file.read(S) 

locking: Locks or unlocks a file region for reading or/ .... locking(S) 

sccsfile: Format of an SCCS file.sccsfile(F) 

stat, fstat: Gets file status.stat(S) 

mount: Mounts a file structure.mount(ADM) 

umount: Dismounts a file structure.umount(ADM) 

syms: common object file symbol table format.syms(F) 

backup: Performs incremental file system backup.backup(ADM) 

fsdb: File system debugger.fsdb(ADM) 

volume, file system: Format of a system . . filesystem(F) 

fstyp: determine file system identifier .fstyp(ADM) 

directory entry, dirent: file system independent.dirent(F) 

fstatfs: get file system information.statfs(S) 

statfs: get file system information.statfs(S) 

mkfs: Constructs a file system.mkfs(ADM) 

commands, fstab: File system mount and check . . . fstab(F) 

mount: Mounts a file system.mount(S) 
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quot: Summarizes file system ownership.quot(C) 

restore, restor: Invokes incremental file system restorer.restore(ADM) 

ustat: Gets file system statistics.ustat(S) 

fsstat: report file system status .fsstat(ADM) 

mnttab: Format of mounted file system table.mnttab(F) 

umount: Unmounts a file system.umount(S) 

Prints or changes the name of a file system fsname: .fsname(ADM) 

haltsys, reboot: Closes out the file systems and shuts down the/ . haltsys(ADM) 

fsck: Checks and repairs file systems.fsck(ADM) 

labelit: provide labels for file systems.labelit(ADM) 

fsck. checklist: List of file systems processed by .... checklist(F) 

systems: Format of UUCP Systems file.. systems(F) 

- mount, unmount multiple file systems /umountall.mountall(ADM) 

tmpfile: Creates a temporary file.tmpfile(S) 

serial/ consoleprint: Print file to printer attached to a .... consoleprint(ADM) 

/converts XENIX-style aliases file to MMDF format.mmdfalias(ADM) 

/a XENIX-style Micnet routing file to MMDF format.mnlist(ADM) 

tsort: Sorts a file topologically.tsort(CP) 

the scheduler for the uucp file transport program uusched: . . uusched(ADM) 

ftw: Walks a file tree.ftw(S) 

file: Determines file type.file(C) 

val: Validates an SCCS file.val(CP) 

write: Writes to a file.write(S) 

Determines accessibility of a file, access: .access(S) 

Format of per-process accounting file, acct: .acct(F) 

for and processes a pattern in a file, awk: Searches.awk(C) 

Changes the owner and group of a file, chown: .chown(S) 

umask: Sets file-creation mode mask.umask(C) 

fields of each line of a file, cut: Cuts out selected .... cut(C) 

a delta (change) to an SCCS file, delta: Makes .delta(CP) 

specified in the mdevice file /device numbers currently . . majorsinuse(ADM) 

of UUCP dial-code abbreviations file, dialcodes: Format .dialcodes(F) 

execlp, execvp: Executes a file, /execv, execle, execve, . . . exec(S) 

directory entries and put in a file, getdents: read.getdents(S) 

object files filehdr: file header for common . . filehdr(F) 

Alternative login terminals file, inittab: .inittab(F) 

file, filelength: Gets the length of a . . fileleng(DOS) 

entries in a common object file linenum: line number .... linenum(F) 

a new filename to an existing file, link: Links.link(S) 

specified in the s d e v i c e file /list of vectors currently . . . vectorsinuse(ADM) 

UUCP uusched limit file, maxuuscheds:.maxuuscheds(F) 

UUCP uuxqt limit file, maxuuxqts:.maxuuxqts(F) 

The Micnet default commands file, micnet: .micnet(F) 

or a special or ordinary file, mknod: Makes a directory, . . mknod(S) 

ctermid: Generates a filename for a terminal.ctermid(S) 

mktemp: Makes a unique filename.mktemp(S) 

link: Links a new filename to an existing file. . . . link(S) 

Changes the format of a text file, newform: .newform(C) 

status, ferror, feof, clearerr, fileno: Determines stream .... ferror(S) 

Format of UUCP Permissions file, permissions: .permissions(F) 

information for a common object file reloc: relocation .reloc(F) 
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remove extra blank lines from a file rmb:.rmb(M) 

Removes a delta from an SCCS file, rmdel:.rmdel(CP) 

csplit: Splits files according to context.csplit(C) 

rep: Copies files across XENIX systems. . . . rcp(C) 

integrity: examine system files against authentication/ . . . integrity(ADM) 

mv: Moves or renames files and directories.mv(C) 

link, unlink: link and unlink files and directories link: .... link(ADM) 

bfs: Scans big files.bfs(C) 

cat: Concatenates and displays files.cat(C) 

emp: Compares two files.cmp(C) 

idmkinit: read files containing specifications . . idmkinit(ADM) 

copy: Copies groups of files.copy(C) 

cp: Copies files.cp(C) 

difi3: Compares three files.difiB(C) 

diff. Compares two text files.difi(C) 

fcntl: Controls open files.fcntl(S) 

find: Finds files.find(C) 

transit queue: MMDF queue files for storing mail in .queue(ADM) 

translate: Translates files from one format to another . . translate(C) 

auditd: read audit collection files generated by the audit/ . . . auditd(ADM) 

cleantmp: remove temporary files in directories specified . . . cleantmp(ADM) 

hd: Displays files in hexadecimal format. . . . hd(C) 

od: Displays files in octal format.od(C) 

mknod: Builds special files.mknod(C) 

dumpdir: Prints the names of files on a backup archive.dumpdir(C) 

imprint: Prints text files on an IMAGEN printer. . . . imprint(C) 

pr: Prints files on the standard output. . . . pr(C) 

rm, rmdir: Removes files or directories.. . rm(C) 

paste: Merges lines of files.paste(C) 

purge: overwrites specified files.purge(C) 

sdiff. Compares files side-by-side.sdiff(C) 

sort: Sorts and merges files.sort(C) 

tar: Archives files.tar(C) 

coffconv: Convert 386 COFF files to XENIX format.coffconv(M) 

bdiffi Compares files too large for diff. .bdiff^C) 

control files, uuinstall: Administers UUCP uuinstall(ADM) 

what: Identifies files.what(C) 

and prints process accounting files, acctcom: Searches for ... acctcom(ADM) 

merge or add total accounting files acctmerg: .acctmerg(ADM) 

Creates and administers SCCS files, admin: .admin(CP) 

Compares two versions of an SCCS file, sccsdiffi .sccsdifl(CP) 

header for a common object file scnhdr: section .scnhdr(F) 

lines common to two sorted files, comm: Selects or rejects . . comm(C) 

format of curses screen image file. scr_dump: .scr_dump(F) 

dosrm, dosrmdir: Access DOS files, dosls,.dos(C) 

file header for common object files filehdr: .filehdr(F) 

format specification in text files fspec:.fspec(F) 

string, format of graphical files gps: graphical primitive . . . gps(F) 

parts of executable binary files, hdr: Displays selected . . . hdr(CP) 

to miscellaneous features and files, intro: Introduction.Intro(M) 

Prints the size of an object file, size: .size(CP) 
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semaphores and record locking on files, lockf: Provide .lockf(S) 

Format of tty device mapping files, mapchan: .mapchan(F) 

unpack: Compresses and expands files, pack, peat,.pack(C) 

access and modification dates of files, settime: Changes the .... settime(ADM) 

miscellaneous features and files, /to machine related .... Intro(HW) 

top.next: The Micnet topology files, top, .top(F) 

printable strings in an object file, strings: Finds the .strings(CP) 

checksum and counts blocks in a file, sum: Calculates .sum(C) 

Gets name list entries from files, xlist, fxlist: .xlist(S) 

Format of UUCP Sysfiles file, sysfiles: .sysfiles(F) 

Interactive, error-checking filesystem backup fsave: .... fsave(ADM) 

mnt: Mount a filesystem .mnt(C) 

The Micnet system identification file, systemid: .systemid(F) 

directory entry dirent: file-system-independent.dirent(F) 

/Default information for mounting filesystems.filesys(F) 

Delivers the last part of a file, tail:.tail(C) 

Dumps magnetic tape to output file, tapedump: .tapedump(C) 

Format of compiled terminfo file, terminfo:.terminfo(F) 

Creates a name for a temporary file, tmpnam, tempnam:.tmpnam(S) 

and modification times of a file, touch: Updates access . . . touch(C) 

Undoes a previous get of an SCCS file, unget:.unget(CP) 

Reports repeated lines in a file, uniq: .uniq(C) 

uucp directories and permissions file uucheck: check the.uucheck(ADM) 

greek: select terminal filter .greek(C) 

col: Filters reverse linefeeds.col(C) 

tplot: graphics filters .tplot(ADM) 

service lpfilter: administer filters used with the LP print . . . lpfilter(ADM) 

driver object module, routines: finds driver entry points in a ... routines(ADM) 

find: Finds files.find(C) 

finger: Finds information about users. . . finger(C) 

logname: Finds login name of user.logname(S) 

object library, lorder: Finds ordering relation for an ... lorder(CP) 
hashmake, spellin, hashcheck: Finds spelling errors, spell, . . . spell(C) 

ttyname, isatty: Finds the name of a terminal. . . . ttyname(S) 
an object file, strings: Finds the printable strings in ... strings(CP) 
of the current user, ttyslot: Finds the slot in the utmp file ... ttyslot(S) 
users, finger: Finds information about . . finger(C) 

dbminit, fetch, store, delete, firstkey, nextkey: Performs/ . . . dbm(S) 

maxuuscheds: UUCP uusched limit file.maxuuscheds(F) 

maxuuxqts: UUCP uuxqt limit file.maxuuxqts(F) 

/Prints formatted output of a varargs argument list.vprintf(S) 

bad track table, badtrk: Scans fixed disk for flaws and creates . . badtrk(ADM) 
binary file headers, fixhdr: Changes executable . . . fixhdr(C) 

badtrk: Scans fixed disk for flaws and creates bad track/ . . . badtrk(ADM) 
frexp, ldexp, modf: Splits floating-point number into a/ . . . frexp(S) 

/fmod: Performs absolute value, floor, ceiling and remainder/ . . . floor(S) 

Performs absolute value, floor,/ floor, fabs, ceil, fmod: .floor(S) 

format: format floppy disks.format(C) 

diskemp: Copies or compares floppy disks, diskep,.diskcp(C) 

fdswap: Swaps default boot floppy drive.fdswap(ADM) 

cflow: Generates C flow graph.cflow(CP) 
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buffers. 

flushall: Flushes all output .... 

flushall(DOS) 

fclose, ffiush: Closes or 

flushes a stream. 

fclose(S) 

flushall: 

Flushes all output buffers. 

flushall(DOS) 

CPU. shutdn: 

Flushes block I/O and halts the . . 

shutdn(S) 

floor,/ floor, fabs, ceil, 

fmod: Performs absolute value, . . 

floor(S) 

device, vidi: Sets the 

font and video mode for a video . . 

vidi(C) 

stream. 

fopen, freopen, fdopen: Opens a 

fopen(S) 


fork: Creates a new process. . . . 

fork(S) 

ar: Archive file 

format. 

ar(F) 

backup: Incremental dump tape 

format. 

backup(F) 

strftime: 

format date/time string . 

strftime(S) 

format: 

format floppy disks. 

format(C) 

pnch: file 

format for card images . 

pnch(F) 

86rel: Intel 8086 Relocatable 

Format for Object Modules. . . . 

86rel(F) 


format: format floppy disks. . . . 

format(C) 

mdevice: file 

format. 

mdevice(F) 

mfsys: file 

format. 

mfsys(F) 

mtune: file 

format. 

mtune(F) 

od: Displays files in octal 

format. 

od(C) 

dir: 

Format of a directory. 

dir(F) 

file system: 

Format of a system volume. . . . 

filesystem(F) 

newform: Changes the 

format of a text file. 

newform(C) 

inode: 

Format of an inode. 

inode(F) 

sccsfile: 

Format of an SCCS file. 

sccsfile(F) 

editor output. a.out: 

Format of assembler and link . . . 

a.out(F) 

file, terminfo: 

Format of compiled terminfo . . . 

terminfo(F) 

core: 

Format of core image file. 

core(F) 

cpio: 

Format of cpio archive. 

cpio(F) 

file. scr_dump: 

format of curses screen image . . 

scr_dump(F) 

gps: graphical primitive string, 

format of graphical files. 

gps(F) 

table, mnttab: 

Format of mounted file system . . 

mnttab(F) 

file, acct: 

Format of per-process accounting . 

acct(F) 

volume fs: file system - 

format of UNIX system . 

fs(F) 

volume fs: file system 

format of UNIX system . 

fs(F) 

group: 

Format of the group file. 

group(M) 

files, mapchan: 

Format of tty device mapping . . 

mapchan(F) 

devices: 

Format of UUCP devices file. . . 

devices(F) 

abbreviations file, dialcodes: 

Format of UUCP dial-code . . . . 

dialcodes(F) 

dialers: 

Format of UUCP Dialers file. . . . 

dialers(F) 

permissions: 

Format of UUCP Permissions file. . 

permissions(F) 

poll: 

Format of UUCP Poll file. 

poll(F) 

sysfiles: 

Format of UUCP Sysfiles file. . . 

sysfiles(F) 

systems: 

Format of UUCP Systems file. . . 

systems(F) 

sdevice: file 

format. 

sdevice(F) 

sfsys: file 

format. 

sfsys(F) 

files fspec: 

format specification in text .... 

fspec(F) 

stune: file 

format. 

stune(F) 

tar: archive 

format. 

tar(F) 

Translates files from one 

format to another translate: . . . 

translate(C) 

Convert 386 COFF files to XENIX 

format, coffconv: . 

coffconv(M) 

Displays files in hexadecimal 

format, hd:. 

hd(C) 
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cscanf: Converts and 
fscanf, sscanf: Converts and 
intro: Introduction to file 
entries, utmp, wtmp: 

cprintf: 
printf, fprintf, sprintf: 
common object file symbol table 
vfprintf, vsprintf: Prints 
service lpforms: administer 
ratfor: Converts Rational 
Rational FORTRAN into standard 
and segment, 
output, printf, 
segment. fp_off, 
character to a stream, 
word on a/ putc, putchar, 
stream, fputc, 
stream, puts, 
binary input and output, 
main memory, malloc, 
fopen, 

floating-point number into a/ 
UNIX system volume 
error-checking filesystem/ 
formats input, scanf, 
systems. 

Repositions a file pointer in a/ 
UNIX system volume fs: 
name of a file system 
text files 

semi-automated system backups 
status 

check commands. 

stat, 

information, 
identifier 
file pointer in a/ fseek, 
time, 

communication package. 

function, erf, erfc: Error 
gamma: Performs log gamma 
setkey: Assigns the 
matherr: Error-handling 
prof: profile within a 
function and complementary error 
math: math 
terminals hp: handle special 
300: 300,300s - handle special 
450/ 450: handle special 


formats console input. . . 
formats input, scanf, . . . 

formats. 

Formats of utmp and wtmp . 

Formats output. 

Formats output. 

format syms:. 

formatted output of a/ vprintf, 
forms used with the LP print 
FORTRAN into standard FORTRAN. 
FORTRAN, ratfor: Converts . 
fp_off, fp_seg: Return oflset 
fprintf, sprintf: Formats . . . 
fp_seg: Return oflset and . . 
fputc, fputchar: Write a ... 
fputc, putw: Puts a character or 
fputchar: Write a character to a 
fputs: Puts a string on a ... 
fread, fwrite: Performs buffered 
free, realloc, calloc: Allocates 
freopen, fdopen: Opens a stream, 
ffexp, ldexp, modf: Splits 
fs: file system - format of 
fsave: Interactive, .... 
fscanf, sscanf: Converts and 
fsck: Checks and repairs file 
fsdb: File system debugger, 
fseek, ftell, rewind: .... 
file system - format of . . 
fsname: Prints or changes the 
fspec: format specification in 
fsphoto: Performs periodic . 
fsstat: report file system . . 
fstab: File system mount and 
fstat: Gets file status. . . . 
fstatfs: get file system . . . 
fstyp: determine file system 
ftell, rewind: Repositions a 
ftime: Gets time and date, 
ftok: Standard interprocess . 
ftw: Walks a file tree. . . . 
function and complementary error 

function. 

function keys. 

function. 

function . 

function, erf, erfc: Error 
functions and constants . . 

functions of Hewlett-Packard 
functions of DASI300/ . . 

functions of the DASI . . . 


cscanf(DOS) 

scanf(S) 

Intro(F) 

utmp(F) 

cprintf(DOS) 

printf(S) 

syms(F) 

vprintf(S) 

lpforms(ADM) 

ratfor(CP) 

ratfor(CP) 

fp_seg(DOS) 

printf(S) 

fp_seg(DOS) 

fj)utc(DOS) 

putc(S) 

fputc(DOS) 

puts(S) 

fread(S) 

malloc(S) 

fopen(S) 

frexp(S) 

fs(F) 

fsave(ADM) 

scanf(S) 

fsck(ADM) 

fsdb(ADM) 

fseek(S) 

fs(F) 

fsname(ADM) 

fspec(F) 

fsphoto(ADM) 

fsstat(ADM) 

fstab(F) 

stat(S) 

statfs(S) 

fstyp(ADM) 

fseek(S) 

time(S) 

stdipc(S) 

ftw(S) 

erf(S) 

gamma(S) 

setkey(C) 

matherr(S) 

prof(M) 

erf(S) 

math(M) 

hp(C) 

300(C) 

450(C) 


1-29 



























Permuted Index 


sysi86: machine specific functions.sysi86(S) 

floor, ceiling and remainder functions, /absolute value, .... floor(S) 

atan2: Performs trigonometric functions, /asin, acos, atan, . . . trig(S) 

jn, yO, yl, yn: Performs Bessel functions, bessel, jO, jl,.bessel(S) 

Performs screen and cursor functions, curses: .curses(S) 

nextkey: Performs database functions, /delete, firstkey, . . . dbm(S) 

logarithm, power, square root functions, /exponential,.exp(S) 

to DOS cross development functions, intro: Introduction . . intro(DOS) 

cosh, tanh: Performs hyperbolic functions, sinh,.sinh(S) 

tgoto, tputs: Performs terminal functions, /tgetflag, tgetstr, . . . termcap(S) 

input and output, fread, fwrite: Performs buffered binary . fread(S) 

manipulate connect accounting/ fwtmp: fwtmp, wtmpfix:.fwtmp(ADM) 

connect accounting/ fwtmp: fwtmp, wtmpfix: manipulate . . . fwtmp(ADM) 

from files, xlist, fxlist: Gets name list entries . . . xlist(S) 

gamma: Performs log gamma function.gamma(S) 

function, gamma: Performs log gamma . . . gamma(S) 

conversions, ecvt, fcvt, gcvt: Performs output.ecvt(S) 

adb: Invokes a general-purpose debugger.adb(CP) 

report, imacct: Generate an IMAGEN accounting . imacct(C) 

user ID diskusg: generate disk accounting data by . diskusg(ADM) 

and /read audit collection files generated by the audit subsystem . auditd(ADM) 

terminal, ctermid: Generates a filename for a .... ctermid(S) 
random: Generates a random number. . . . random(C) 

rand, srand: Generates a random number. . . . rand(S) 

makekey: Generates an encryption key. . . . makekey(M) 

abort: Generates an IOT fault.abort(S) 

cflow: Generates C flow graph.cflow(CP) 

cross-reference, cxref: Generates C program.cxref(CP) 

numbers, ncheck: Generates names from inode . . . ncheck(ADM) 

analysis, lex: Generates programs for lexical . . lex(CP) 

srand48, seed48, lcong48: Generates uniformly distributed. . drand48(S) 

MMDF queue status report generator checkque: .checkque(ADM) 

value machid: machid, i386 get processor type truth.machid(C) 

character or word from a/ getc, getchar, fgetc, getw: Gets . . getc(S) 

getch: Gets a character.getch(DOS) 

character or word from a/ getc, getchar, fgetc, getw: Gets .... getc(S) 

character, getche: Gets and echoes a .... getche(DOS) 

real-time clock getclk: gets string from.getclk(M) 

current working directory, getcwd: Get the pathname of . . . getcwd(S) 
and put in a file, getdents: read directory entries . . getdents(S) 

getuid, geteuid, getgid, getegid: Gets real user,/.getuid(S) 

environment name, getenv: Gets value for .getenv(S) 

real user, effective/ getuid, geteuid, getgid, getegid: Gets . . . getuid(S) 

effective/ getuid, geteuid, getgid, getegid: Gets real user, . . getuid(S) 

setgrent, endgrent: Get group/ getgrent, getgrgid, getgmam, . . . getgrent(S) 

endgrent: Get group/ getgrent, getgrgid, getgmam, setgrent, . . . getgrent(S) 

Get group/ getgrent, getgrgid, getgmam, setgrent, endgrent: . . . getgrent(S) 

getlogin: Gets login name.getlogin(S) 

argument vector, getopt: Gets option letter from . . getopt(S) 

getopt: Parses command options. . getopt(C) 

options getopts: getopts, getoptcvt - parse command . . . getopts(C) 
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command options getopts: 

getopts, getoptcvt - parse . . . 

. getopts(C) 

parse command options 

getopts: getopts, getoptcvt - . . 

. getopts(C) 


getpass: Reads a password. . . 

. getpass(S) 

process group, and/ getpid. 

getpgrp, getppid: Gets process. 

. getpid(S) 

process, process group, and/ 

getpid, getpgrp, getppid: Gets 

. getpid(S) 

group, and/ getpid, getpgrp. 

getppid: Gets process, process 

. getpid(S) 

user ID. 

getpw: Gets password for a given 

. getpw(S) 

setpwent, endpwent: Gets/ getpwent, getpwuid, getpwnam, . 

. getpwent(S) 

Gets/ getpwent, getpwuid. 

getpwnam, setpwent, endpwent: 

. getpwent(S) 

endpwent: Gets/ getpwent, 

getpwuid, getpwnam, setpwent, . 

. getpwent(S) 

fgetc, fgetchar: 

Gets a character from a stream. . 

. fgetc(DOS) 

getch: 

Gets a character. 

. getch(DOS) 

an event queue. ev_getdev: 

Gets a list of devices feeding . . 

. ev_getdev(S) 

shmget: 

Gets a shared memory segment. . 

. shmget(S) 

cgets: 

Gets a string. 

. cgets(DOS) 

gets, fgets: 

Gets a string from a stream. . . 

. gets(S) 

input, gets: 

Gets a string from the standard 

. gets(CP) 

getche: 

Gets and echoes a character. . . 

. getche(DOS) 

ulimit: 

Gets and sets user limits. . . . 

. ulimit(S) 

getc, getchar, fgetc, getw: 

Gets character or word from a/ 

. getc(S) 

dosexterr: 

Gets DOS error messages. . . . 

. dosexter(DOS) 

nlist: 

Gets entries from name list. . . 

. nlist(S) 

a stream. 

gets, fgets: Gets a string from . . 

• gets(S) 

umask: Sets and 

gets file creation mask. 

. umask(S) 

stat, fstat: 

Gets file status. 

. stat(S) 

ustat: 

Gets file system statistics. . . . 

. ustat(S) 

standard input. 

gets: Gets a string from the . . 

. gets(CP) 

getlogin: 

Gets login name. 

. getlogin(S) 

logname: 

Gets login name. 

. logname(C) 

msgget: 

Gets message queue. 

. msgget(S) 

files, xlist, fxlist: 

Gets name list entries from . . 

. xlist(S) 

system, uname: 

Gets name of current XENIX . . 

. uname(S) 

vector, getopt: 

Gets option letter from argument 

. getopt(S) 

/getpwnam, setpwent, endpwent: 

Gets password file entry. . . . 

. getpwent(S) 

ID. getpw: 

Gets password for a given user 

. getpw(S) 

times, times: 

Gets process and child process 

. times(S) 

getpid, getpgrp, getppid: 

Gets process, process group, and/ 

. getpid(S) 

real/ /geteuid, getgid, getegid: 

Gets real user, effective user, . . 

. getuid(S) 

semget: 

Gets set of semaphores. 

. semget(S) 

getclk: 

gets string from real-time clock . 

. getclk(M) 

file pointer, tell: 

Gets the current position of the 

. tell(DOS) 

filelength: 

Gets the length of a file. 

. fileleng(DOS) 

cuserid: 

Gets the login name of the user. . 

. cuserid(S) 

tty: 

Gets the terminal’s name. . . . 

. tty(C) 

time, ftime: 

Gets time and date. 

. time(S) 

getenv: 

Gets value for environment name. 

. getenv(S) 

modes, speed, and line/ 

getty: Sets terminal type, . . . 

. getty(M) 

ct: spawn 

getty to a remote terminal . . . 

. ct(C) 

settings used by getty. 

gettydefs: Speed and terminal 

. gettydefs(F) 

and terminal settings used by 

getty. gettydefs: Speed .... 

. gettydefs(F) 

security actions for init and 

getty initcond: special .... 

. initcond(ADM) 
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getegid: Gets real user,/ getuid, geteuid, getgid, .getuid(S) 

from a/ getc, getchar, fgetc, getw: Gets character or word . . . getc(S) 

of directories. Is: Gives information about contents . ls(C) 

date and time/ ctime, localtime, gmtime, asctime, tzset: Converts . ctime(S) 

non-obviousness, goodpw: Check a password for . . goodpw(ADM) 

longjmp: Performs a nonlocal “goto”, setjmp,.setjmp(S) 

and checks access to a resource governed by a semaphore. /Awaits waitsem(S) 
format of graphical files gps: graphical primitive string, . . gps(F) 

cflow: Generates C flow graph.cflow(CP) 

graph: draw a graph .graph(ADM) 

graph: draw a graph .graph(ADM) 

sag: system activity graph .sag(ADM) 

primitive string, format of graphical files gps: graphical . . gps(F) 

format of graphical files gps: graphical primitive string, .... gps(F) 

tplot: graphics filters .tplot(ADM) 

plot: graphics interface .plot(F) 

greek: select terminal filter .... greek(C) 
file for a pattern, grep, egrep, fgrep: Searches a . . grep(C) 

/real user, effective user, real group, and effective group IDs. . . getuid(S) 

/getppid: Gets process, process group, and parent process IDs. . . getpid(S) 

newgrp: Logs user into a new group.newgrp(C) 

passwd: Change login, group, or dialup shell password. . . passwd(C) 

copy: Copies groups of files.copy(C) 

updates, and regenerates groups of programs. /Maintains, . make(CP) 
grpcheck: Checks group file. . . . grpcheck(C) 

signals, ssignal, gsignal: Implements software . . ssignal(S) 

shutdn: Flushes block I/O and halts the CPU.shutdn(S) 

file systems and shuts down the/ haltsys, reboot: Closes out the . . haltsys(ADM) 

Hewlett-Packard terminals hp: handle special functions of ... . hp(C) 

nohup: Runs a command immune to hangups and quits.nohup(C) 

cmchk: Reports hard disk block size.cmchk(C) 

dparam: Displays/changes hard disk characteristics.dparam(ADM) 

hd: Internal hard disk drive.hd(HW) 

hcreate, hdestroy: Manages hash search tables, hsearch, . . . hsearch(S) 

spell, hashmake, spellin, hashcheck: Finds spelling/ .... spell(C) 

Finds spelling errors, spell, hashmake, spellin, hashcheck: . . spell(C) 

search tables, hsearch, hcreate, hdestroy: Manages hash . hsearch(S) 

hexadecimal format, hd: Displays files in .hd(C) 

hd: Internal hard disk drive. . . . hd(HW) 

tables, hsearch, hcreate, hdestroy: Manages hash search . . hsearch(S) 

executable binary files, hdr: Displays selected parts of . . hdr(CP) 

scnhdr: section header for a common object file . . scnhdr(F) 

filehdr: file header for common object files . . filehdr(F) 

limits: file header for/.limits(F) 

unistd: file header for symbolic constants . . unistd(F) 

Changes executable binary file headers, fixhdr:.fixhdr(C) 

user, hello: Send a message to another . hello(ADM) 

program, assert: Helps verify validity of.assert(S) 

hp: handle special functions of Hewlett-Packard terminals .... hp(C) 

hd: Displays files in hexadecimal format.hd(C) 

layers: protocol used between host and windowing terminal/ . . layers(M) 
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terminal jagent: host control of windowing .... jagent(M) 

Machine: Description of host machine.machine(HW) 

Hewlett-Packard terminals hp: handle special functions of . . hp(C) 

Manages hash search tables, hsearch, hcreate, hdestroy: .... hsearch(S) 

information, hwconfig: Read the configuration . hwconfig(ADM) 

sinh, cosh, tanh: Performs hyperbolic functions.sinh(S) 

Euclidean distance, hypot, cabs: Determines.hypot(S) 

i286emul: emulate 80286 .... i286emul(C) 

value machid: machid, i386 - get processor type truth . . machid(C) 

chgrp: Changes group ID.chgrp(C) 

chown: Changes owner ID.chown(C) 

IDs and names id: print user and group.id(ADM) 

and names, id: Prints user and group IDs . . . id(C) 

setpgrp: Sets process group ID.setpgrp(S) 

kernel idbuild: build new UNIX system . idbuild(ADM) 
information idcheck: returns selected .... idcheck(ADM) 

disk accounting data by user ID diskusg: generate.diskusg(ADM) 

issue: issue identification file .issue(F) 

systemid: The Micnet system identification file.systemid(F) 

fstyp: determine file system identifier.fstyp(ADM) 

devnm: Identifies device name.devnm(C) 

what: Identifies files.what(C) 

Gets password for a given user ID. getpw:.getpw(S) 

or get device driver/ idinstall: add, delete, update, . . . idinstall(ADM) 

idleout: Logs out idle users.idleout(ADM) 

idleout: Logs out idle users. . . . idleout(ADM) 

specifications idmkinit: read files containing . . idmkinit(ADM) 

id: Prints user and group IDs and names.id(C) 

group, and parent process IDs. /Gets process, process . . . getpid(S) 

idspace: investigates free space . . idspace(ADM) 

real group, and effective group IDs. A-eal user, effective user, . . getuid(S) 

setgid: Sets user and group IDs. setuid,.setuid(S) 

a tunable parameter idtune: attempts to set value of . . idtune(ADM) 

accounting report, imacct: Generate an IMAGEN . . imacct(C) 

core: Format of core image file.core(F) 

mem, kmem: Memory image file.mem(M) 

format of curses screen image file. scr_dump: .scr_dump(F) 

imacct: Generate an IMAGEN accounting report. . . . imacct(C) 

imprint: Prints text files on an IMAGEN printer.imprint(C) 

/imagen.spp, imagen.remote: IMAGEN printer interface/ . . . imagen(M) 

imagen.remote:/ imagen.sbs, imagen.pbs, imagen.spp, .... imagen(M) 
/imagen.pbs, imagen.spp, imagen.remote: IMAGEN printer/ . imagen(M) 

imagen.spp, imagen.remote:/ imagen.sbs, imagen.pbs,.imagen(M) 

IMAGEN/ imagen.sbs, imagen.pbs, imagen.spp, imagen.remote: . . . imagen(M) 

crash: examine system images .crash(ADM) 

pnch: file format for card images .pnch(F) 

nohup: Runs a command immune to hangups and quits. . . nohup(C) 
limits: file header for implementation-specific/ .... limits(F) 
ssignal, gsignal: Implements software signals. . . . ssignal(S) 
IMAGEN printer, imprint: Prints text files on an . . imprint(C) 
event input. ev_gindev: include/exclude devices for ... ev_gindev(S) 
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backup: Incremental backup tape format. . backup(F) 
backup: Performs incremental file system backup. . . backup(ADM) 

restore, restor: Invokes incremental file system/.restore(ADM) 

dirent: file system independent directory entry. . . . dirent(F) 

and teletypes last: Indicate last logins of users . . . last(C) 

terminfo descriptions infocmp: compare or print out . . infocmp(ADM) 

/Default backup device information.archive(F) 

hwconfig: Read the configuration information.hwconfig(ADM) 

pstat: Reports system information.pstat(C) 

fstatfs: get file system information.statfs(S) 

statfs: get file system information.statfs(S) 

database of alias and routing information, /hashed.dbmbuild(ADM) 

prints lineprinter status information, lpstat: .lpstat(C) 

initialization, init, inir: Process control .init(M) 

special security actions for init and getty initcond: .initcond(ADM) 

initialization, init, inir: Process control .... init(M) 

actions for init and getty initcond: special security .... initcond(ADM) 

init, inir: Process control initialization.init(M) 

brc: brc, bcheckrc - system initialization procedures.brc(ADM) 

process, popen, pclose: Initiates I/O to or from a.popen(S) 

terminals file, inittab: Alternative login .... inittab(F) 

clri: Clears inode.clri(ADM) 

inode: Format of an inode.inode(F) 

inode: Format of an inode.inode(F) 

ncheck: Generates names from inode numbers.ncheck(ADM) 

inp: Returns a byte.inp(DOS) 

fwrite: Performs buffered binary input and output, ffead,.fread(S) 

Performs standard buffered input and output, stdio:.stdio(S) 

Pushes character back into input stream, ungetc:.ungetc(S) 

usemouse: Maps mouse input to keystrokes.usemouse(C) 

Converts and formats console input, cscanf:.cscanf(DOS) 

Opens an event queue for input. ev_open:.ev_open(S) 

Gets a string from the standard input, gets:.gets(CP) 

devices for event input, /include/exclude.ev_gindev(S) 

sscanf: Converts and formats input, scanf, fscanf, .scanf(S) 

uustat: uucp status inquiry and job control.uustat(C) 

script, install: Installation shell.install(M) 

installpkg: install package .installpkg(ADM) 

install: Installation shell script.install(M) 

xinstall: XENIX installation shell script .xinstall(ADM) 

removepkg: remove installed package .removepkg(ADM) 

displaypkg: display installed packages .displaypkg(ADM) 

installpkg: install package .... installpkg(ADM) 

creatsem: Creates an instance of a binary semaphore. . . creatsem(S) 

int86: Executes an interrupt. . . . int86(DOS) 

int86x: Executes an interrupt. . . int86x(DOS) 
call, intdos: Invokes a DOS system . . intdos(DOS) 

call, intdosx: Invokes a DOS system . . intdosx(DOS) 

abs: Returns an integer absolute value.abs(S) 

/164a: Converts between long integer and base 64 ASCII. . . . a641(S) 

sputl, sgetl: Accesses long integer data in a/.sputl(S) 
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the absolute value of a long integer, labs: Returns.labs(DOS) 

/ltol3: Converts between 3-byte integers and long integers.13tol(S) 

itoa: Converts numbers to integers.itoa(DOS) 

ltoa: Converts long integers to characters.ltoa(DOS) 

between 3-byte integers and long integers. /ltol3: Converts .... 13tol(S) 

atol, atoi: Converts string to integer, strtol, .strtol(S) 

against authentication database integrity: examine system files . . integrity(ADM) 

for Object Modules. 86rel: Intel 8086 Relocatable Format . . 86rel(F) 

filesystem backup fsave: Interactive, error-checking .... fsave(ADM) 
system mailx: interactive message processing . . mailx(C) 

audit: audit subsystem interface device.audit(ADM) 

activation,/ auditcmd: command interface for audit subsystem . . . auditcmd(ADM) 
authtsh: administrator interface for authorization/ .... authtsh(ADM) 

plot: graphics interface.plot(F) 

rtc: real time clock interface.rtc(HW) 

imagen.remote: IMAGEN printer interface scripts, /imagen.spp, . . imagen(M) 

scsi: Small computer systems interface.scsi(HW) 

swap: swap administrative interface.swap(ADM) 

termio: General terminal interface.termio(M) 

termios: POSIX general terminal interface.termios(M) 

/, tty2[a-h], tty2[A-H]: Interface to serial ports.serial(HW) 

tty: Special terminal interface.tty(M) 

lpl,lp2: Line printer device interfaces. Ip, lpO,.lp(HW) 

Authentication/ authck: check internal consistency of .authck(ADM) 

hd: Internal hard disk drive.hd(HW) 

setlocale: Set or read international environment .... setlocale(S) 

locale: The international locale.locale(M) 

spline: Interpolates smooth curve.spline(CP) 

sh: Invokes the shell command interpreter.sh(C) 

csh: Invokes a shell command interpreter with C-like syntax. . . csh(C) 

a restricted shell (command interpreter), rsh: Invokes .... rsh(C) 
ipcs: Reports the status of inter-process communication/ . . ipcs(ADM) 
package, ftok: Standard interprocess communication . . . stdipc(S) 

pipe: Creates an interprocess pipe.pipe(S) 

int86: Executes an interrupt.int86(DOS) 

int86x: Executes an interrupt.int86x(DOS) 

sleep: Suspends execution for an interval.sleep(C) 

sleep: Suspends execution for an interval.sleep(S) 

Suspends execution for a short interval, nap:.nap(S) 

services, library routines and/ intro: Introduces system.Intro(S) 

commands, intro: Introduces XENIX .... Intro(C) 
Development System commands, intro: Introduces XENIX .... Intro(CP) 
development functions, intro: Introduction to DOS cross . intro(DOS) 
formats, intro: Introduction to file .... Intro(F) 

miscellaneous features and/ intro: Introduction to.Intro(M) 

related miscellaneous features/ intro: Introduction to machine . . Intro(HW) 

library routines and/ intro: Introduces system services, . . . Intro(S) 

intro: Introduces XENIX commands. . . Intro(C) 

System commands, intro: Introduces XENIX Development . Intro(CP) 
development functions, intro: Introduction to DOS cross .... intro(DOS) 
intro: Introduction to file formats. . . . Intro(F) 
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miscellaneous features/ intro: Introduction to machine related . . Intro(HW) 

features and files, intro: Introduction to miscellaneous . . Intro(M) 

idspace: investigates free space .idspace(ADM) 

be: Invokes a calculator. ..bc(C) 

yacc: Invokes a compiler-compiler. . . . yacc(CP) 

bdos: Invokes a DOS system call. . . . bdos(DOS) 

intdos: Invokes a DOS system call. . . . intdos(DOS) 

intdosx: Invokes a DOS system call. . . . intdosx(DOS) 

debugger, adb: Invokes a general-purpose .... adb(CP) 
m4: Invokes a macro processor. . . . m4(CP) 

calendar: Invokes a reminder service. . . . calendar(C) 

(command interpreter), rsh: Invokes a restricted shell .... rsh(C) 
red: Invokes a restricted version of. . . red(C) 

display/ vi, view, vedit: Invokes a screen-oriented .... vi(C) 

interpreter with C-like/ esh: Invokes a shell command .... csh(C) 

ex: Invokes a text editor.ex(C) 

calculator, dc: Invokes an arbitrary precision . . dc(C) 

restore, restor: Invokes incremental file system/ . restore(ADM) 

incremental file/ xrestore: Invokes XENIX .xrestore(ADM) 

sdb: Invokes symbolic debugger. . . . sdb(CP) 

cc: Invokes the C compiler.cc(CP) 

ev_init: Invokes the event manager. . . . ev_init(S) 

Id: Invokes the link editor.ld(CP) 

Id: Invokes the link editor.ld(M) 

interpreter, sh: Invokes the shell command . . . sh(C) 

sed: Invokes the stream editor.sed(C) 

ed: Invokes the text editor.ed(C) 

masm: Invokes the XENIX assembler. . . masm(CP) 

shutdn: Flushes block I/O and halts the CPU.shutdn(S) 

select: synchronous I/O multiplexing.select(S) 

popen, pclose: Initiates I/O to or from a process.popen(S) 

devices, ioctl: Controls character.ioctl(S) 

abort: Generates an IOT fault.abort(S) 

semaphore set or shared memory, iperm: Removes a message queue, ipcrm(ADM) 
inter-process communication/ ipcs: Reports the status of .... ipcs(ADM) 
/islower, isdigit, isxdigit, isalnum, isspace, ispunct,/ .... ctype(S) 
isdigit, isxdigit,/ ctype, isalpha, isupper, islower, .... ctype(S) 

/isprint, isgraph, iscntrl, isascii, tolower, toupper,/ .... ctype(S) 

device, isatty: Checks for a character . . . isatty(DOS) 

terminal, ttyname, isatty: Finds the name of a .... ttyname(S) 

/ispunct, isprint, isgraph, iscntrl, isascii, tolower,/.ctype(S) 

/isalpha, isupper, islower, isdigit, isxdigit, isalnum,/ .... ctype(S) 

/isspace, ispunct, isprint, isgraph, iscntrl, isascii,/.ctype(S) 

ctype, isalpha, isupper, islower, isdigit, isxdigit,/ .... ctype(S) 
state ismpx: return windowing terminal . ismpx(C) 

/isalnum, isspace, ispunct, isprint, isgraph, iscntrl,/.ctype(S) 

/isxdigit, isalnum, isspace, ispunct, isprint, isgraph,/ .... ctype(S) 

/isdigit, isxdigit, isalnum, isspace, ispunct, isprint,/ .... ctype(S) 

issue: issue identification file .issue(F) 

issue: issue identification file ... issue(F) 
isxdigit,/ ctype, isalpha, isupper, islower, isdigit,.ctype(S) 
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/isupper, islower, isdigit, isxdigit, isalnum, isspace,/ .... ctype(S) 

news: Print news items.news(C) 

integers, itoa: Converts numbers to .... itoa(DOS) 
Bessel functions, bessel, jO, jl,jn, yO, yl, yn: Performs . . bessel(S) 
Bessel functions, bessel, jO, jl,jn, yO, yl, yn: Performs .... bessel(S) 

windowing terminal jagent: host control of .jagent(M) 

functions, bessel, jO,jl, jn, yO, yl, yn: Performs Bessel . . bessel(S) 

join: Joins two relations.join(C) 

join: Joins two relations.join(C) 

terminal jterm: reset layer of windowing . . jterm(C) 

jwin: print size of layer.jwin(C) 

keystroke, kbhit: Checks the console for a . . kbhit(DOS) 
test keyboard support kbmode: Set keyboard mode or . . kbmode(ADM) 
error: Kernel error output device. . . . error(M) 

idbuild: build new UNIX system kernel.idbuild(ADM) 

makekey: Generates an encryption key.makekey(M) 

keyboard: The PC keyboard.keyboard(HW) 

support kbmode: Set keyboard mode or test keyboard . kbmode(ADM) 

Set keyboard mode or test keyboard support kbmode: . . . kbmode(ADM) 

keyboard: The PC keyboard. . . . keyboard(HW) 

setkey: Assigns the function keys.setkey(C) 

kbhit: Checks the console for a keystroke.kbhit(DOS) 

usemouse: Maps mouse input to keystrokes .usemouse(C) 

killall: kill all active processes.killall(ADM) 

process or a group of/ kill: Sends a signal to a.kill(S) 

kill: Terminates a process.kill(C) 

processes killall: kill all active .killall(ADM) 

mem, kmem: Memory image file. . . . mem(M) 

contents of directory. 1: Lists information about .... 1(C) 

3-byte integers and long/ 13tol, ltol3: Converts between . . 13tol(S) 

integer and base 64/ a641, 164a: Converts between long . . . a641(S) 

systems labelit: provide labels for file ... labelit(ADM) 

labelit: provide labels for file systems.labelit(ADM) 

of a long integer, labs: Returns the absolute value . . labs(DOS) 

cpp: The C language preprocessor.cpp(CP) 

lint: Checks C language usage and syntax. . . . lint(CP) 

/chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm,/ . . . acctsh(ADM) 

jwin: print size of layer .jwin(C) 

shl: Shell layer manager.shl(C) 

terminals layers: layer multiplexer for windowing . layers(C) 

jterm: reset layer of windowing terminal . . . jterm(C) 

login entry to show current layer relogin: rename .relogin(ADM) 

windowing terminals layers: layer multiplexer for ... layers(C) 
host and windowing terminal/ layers: protocol used between . . layers(M) 

columns, lc: Lists directory contents in . . . lc(C) 

distributed. srand48, seed48, lcong48: Generates uniformly . . drand48(S) 

Id: Invokes the link editor.ld(CP) 

Id: Invokes the link editor.ld(M) 

floating-point number/ frexp, ldexp, modf: Splits.frexp(S) 

routines ldfcn: common object file access . ldfcn(F) 
filelength: Gets the length of a file.fileleng(DOS) 
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strlen: Returns the length of a string.strlen(DOS) 

getopt: Gets option letter from argument vector. . . . getopt(S) 

banner: Prints large letters.banner(C) 

lexical analysis, lex: Generates programs for ... lex(CP) 

lex: Generates programs for lexical analysis.lex(CP) 

and update, lsearch, lfind: Performs linear search . . . lsearch(S) 

ar: Maintains archives and libraries.ar(CP) 

Converts archives to random libraries, ranlib:.ranlib(CP) 

/Introduces system services, library routines and error/ .... Intro(S) 

ordering relation for an object library, lorder: Finds.lorder(CP) 

maxuuscheds: UUCP uusched limit file.maxuuscheds(F) 

maxuuxqts: UUCP uuxqt limit file.. maxuuxqts(F) 

implementation-specific/ limits: file header for.limits(F) 

ulimit: Gets and sets user limits.ulimit(S) 

line: Reads one line.line(C) 

lsearch, lfind: Performs linear search and update.lsearch(S) 

col: Filters reverse linefeeds.col(C) 

a common object file linenum: line number entries in . . linenum(F) 

lpshut, lpmove: Starts/stops the lineprinter request, lpsched, . . . lpsched(ADM) 

lpadmin: Configures the lineprinter spooling system. . . . lpadmin(ADM) 

lpstat: prints lineprinter status information. . . lpstat(C) 

cancel: Send/cancel requests to lineprinter. Ip.lp(C) 

Adds, reconfigures and maintains lineprinters. lpinit:.lpinit(ADM) 

files, comm: Selects or rejects lines common to two sorted . . . comm(C) 

rmb: remove extra blank lines from a file .rmb(M) 

uniq: Reports repeated lines in a file.uniq(C) 

head: Prints the first few lines of a stream.head(C) 

paste: Merges lines of files.paste(C) 

wc: Counts lines, words and characters. . . . wc(C) 

directories link: link, unlink: link and unlink files and.link(ADM) 

Id: Invokes the link editor.ld(CP) 

Id: Invokes the link editor.ld(M) 

a.out: Format of assembler and link editor output.a.out(F) 

unlink files and directories link: link, unlink: link and .... link(ADM) 

existing file, link: Links a new filename to an . link(S) 

In: Makes a link to a file.ln(C) 

files and directories link: link, unlink: link and unlink . . . link(ADM) 

dosld: XENIX to MS-DOS cross linker.dosld(CP) 

existing file, link: Links a new filename to an ... . link(S) 

UNIX system kernel. link_unix: builds a new.link_unix(ADM) 

and syntax, lint: Checks C language usage . . lint(CP) 

xlist, fxlist: Gets name list entries from files.xlist(S) 

MMDF list: list processor channel for . . list(ADM) 

nlist: Gets entries from name list.nlist(S) 

nm: Prints name list.nm(CP) 

queue. ev_getdev: Gets a list of devices feeding an event . . ev_getdev(S) 

by fsck. checklist: List of file systems processed . . . checklist(F) 

majorsinuse: displays the list of major device numbers/ . . . majorsinuse(ADM) 

terminals: List of supported terminals. . . . terminals(M) 

swconfig: produces a list of the software/.swconfig(C) 

vectorsinuse: displays the list of vectors currently/.vectorsinuse(ADM) 
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list: list processor channel for MMDF . list(ADM) 

varargs: variable argument list.varargs(S) 

nlsadmin: network listener service administration . . nlsadmin(ADM) 

cref: Makes a cross-reference listing..cref(CP) 

of a varargs argument list. /Prints formatted output . . . vprintf(S) 

columns, lc: Lists directory contents in .... lc(C) 

of directory. 1: Lists information about contents . 1(C) 

who: Lists who is on the system.who(C) 

file system volcopy: make literal copy of UNIX .volcopy(ADM) 

In: Makes a link to a file.ln(C) 

mestbl: create a messages locale file .mestbl(M) 

locale: The international locale.locale(M) 

chrtbl: create a ctype locale table.chrtbl(M) 

coltbl: create a collation locale table.coltbl(M) 

curtbl: create a currency locale table.curtbl(M) 

numtbl: Create a numeric locale table.numtbl(M) 

locale, locale: The international .... locale(M) 
network, mmdf: routes mail locally and over any supported . . mmdf(ADM) 

tzset: Converts date and I ctime, localtime, gmtime, asctime, . . . ctime(S) 

end, etext, edata: Last locations in program.end(S) 

memory, lock: Locks a process in primary . lock(S) 
lock: Locks a user’s terminal. . . lock(C) 
memory, plock: Lock process, text, or data in . . . plock(S) 

record locking on files, lockf: Provide semaphores and . . lockf(S) 

region for reading or writing, locking: Locks or unlocks a file . . locking(S) 

Provide semaphores and record locking on files, lockf: .lockf(S) 

memory, lock: Locks a process in primary . . . lock(S) 

lock: Locks a user’s terminal.lock(C) 

for reading or/ locking: Locks or unlocks a file region . . locking(S) 

gamma: Performs log gamma function.gamma(S) 

exponential, logarithm,/exp, log, pow, sqrt, log 10: Performs . . exp(S) 

logarithm,/ exp, log, pow, sqrt, log 10: Performs exponential, . . . exp(S) 

/log 10: Performs exponential, logarithm, power, square root/ . . exp(S) 

logs: MMDF logfiles .logs(F) 

strclean: STREAMS error logger cleanup program.strclean(ADM) 

strerr: STREAMS error logger daemon .strerr(ADM) 

layer relogin: rename login entry to show current . . . relogin(ADM) 

password, passwd: Change login, group, or dialup shell . . . passwd(C) 

getlogin: Gets login name.getlogin(S) 

logname: Gets login name.logname(C) 

cuserid: Gets the login name of the user.cuserid(S) 

logname: Finds login name of user.logname(S) 

passwd: Changes login password.passwd(C) 

terminal: Login terminal.terminal(HW) 

inittab: Alternative login terminals file.inittab(F) 

Sets up an environment at login time, profile:.profile(M) 

last: Indicate last logins of users and teletypes . . . last(C) 

user, logname: Finds login name of . . logname(S) 

logname: Gets login name.logname(C) 

logs: MMDF logfiles.logs(F) 

idleout: Logs out idle users.idleout(ADM) 
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newgrp: Logs user into a new group. . . . newgrp(C) 
“goto”, setjmp, longjmp: Performs a nonlocal . . setjmp(S) 
for an object library, lorder: Finds ordering relation . . lorder(CP) 

uppercase, strupr: Converts lowercase characters to.strupr(DOS) 

Converts uppercase characters to lowercase, strlwr: .strlwr(DOS) 

requests to lineprinter. Ip, cancel: Send/cancel .lp(C) 

device interfaces. Ip, lpO, lpl, lp2: Line printer . . . lp(HW) 
utility lpsh: Menu driven lp print service administration . . lpsh(ADM) 
administer filters used with the LP print service lpfilter: .... lpfilter(ADM) 

administer forms used with the LP print service lpforms: .... lpforms(ADM) 
device interfaces, lp, lpO, lpl, lp2: Line printer .... lp(HW) 
interfaces, lp, lpO, lpl, lp2: Line printer device . . . lp(HW) 

interfaces, lp, lpO, lpl, lp2: Line printer device.lp(HW) 

lineprinter spooling system, lpadmin: Configures the.lpadmin(ADM) 

used with the LP print service lpfilter: administer filters .... lpfilter(ADM) 
with the LP print service lpforms: administer forms used . . lpforms(ADM) 
maintains lineprinters. lpinit: Adds, reconfigures and . . lpinit(ADM) 

lineprinter/ lpsched, lpshut, lpmove: Starts/stops the.lpsched(ADM) 

attached to the user’s terminal lprint: Print to a printer .lprint(C) 

Starts/stops the lineprinter/ lpsched, lpshut, lpmove:.lpsched(ADM) 

service administration utility lpsh: Menu driven lp print .... lpsh(ADM) 

lineprinter request, lpsched, lpshut, lpmove: Starts/stops the . . lpsched(ADM) 

status information, lpstat: prints lineprinter.lpstat(C) 

priorities lpusers: set printing queue .... lpusers(ADM) 
contents of directories. Is: Gives information about . . . ls(C) 

search and update, lsearch, lfind: Performs linear . . lsearch(S) 

pointer, lseek: Moves read/write file ... lseek(S) 
characters, ltoa: Converts long integers to . . ltoa(DOS) 
integers and long/ 13tol, ltol3: Converts between 3-byte . . 13tol(S) 

m4: Invokes a macro processor. . . m4(CP) 

type truth value machid: machid, i386 - get processor . . . machid(C) 

processor type truth value machid: machid, i386 - get .... machid(C) 

machine. Machine: Description of host . . . machine(HW) 

Machine: Description of host machine.machine(HW) 

features/ intro: Introduction to machine related miscellaneous . . Intro(HW) 

sysi86: machine specific functions. . . . sysi86(S) 

values: machine-dependent values .... values(M) 
Accesses long integer data in a machine-independent, /sgetl: . . sputl(S) 

m4: Invokes a macro processor.m4(CP) 

program, tape: Magnetic tape maintenance . . . tape(C) 

tapedump: Dumps magnetic tape to output file. . . . tapedump(C) 

deliver: MMDF mail delivery process.deliver(ADM) 

submit: MMDF mail enqueuer.submit(ADM) 

MMDF queue files for storing mail in transit queue:.queue(ADM) 

supported network, mmdf: routes mail locally and over any .... mmdf(ADM) 

msg:read mail.msg(C) 

rmail: submit remote mail received via UUCP .... rmail(ADM) 
of mail, mail: Sends, reads or disposes . . mail(C) 

but not/ checkmail: checks for mail which has been submitted . . checkmail(C) 

daemon.mn: Micnet mailer daemon.daemon.mn(M) 

Sends, reads or disposes of mail, mail:.mail(C) 
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binary file for transmission via mail uudecode: decode a .... uuencode(C) 

binary file for transmission via mail uuencode: encode a .... uuencode(C) 

processing system mailx: interactive message .... mailx(C) 

free, realloc, calloc: Allocates main memory, malloc, .malloc(S) 

fdisk: Maintain disk partitions.fdisk(ADM) 

libraries, ar: Maintains archives and.ar(CP) 

lpinit: Adds, reconfigures and maintains lineprinters.lpinit(ADM) 

regenerates groups of/ make: Maintains, updates, and.make(CP) 

systty: System maintenance device.systty(M) 

tape: Magnetic tape maintenance program.tape(C) 

of major device numbers/ majorsinuse: displays the list . . . majorsinuse(ADM) 
key. makekey: Generates an encryption makekey(M) 
cref: Makes a cross-reference listing. . . cref(CP) 

execseg: makes a data region executable. . execseg(S) 

SCCS file, delta: Makes a delta (change) to an ... delta(CP) 

mkdir: Makes a directory.mkdir(C) 

or ordinary file, mknod: Makes a directory, or a special . . mknod(S) 

In: Makes a link to a file.ln(C) 

mktemp: Makes a unique filename.mktemp(S) 

another user, su: Makes the user a super-user or . . su(C) 

Allocates main memory, malloc, free, realloc, calloc: . . . malloc(S) 

ev_init: Invokes the event manager.ev_init(S) 

shl: Shell layer manager.shl(C) 

tsearch, tfind, tdelete, twalk: Manages binary search trees. . . . tsearch(S) 

hsearch, hcreate, hdestroy: Manages hash search tables. . . . hsearch(S) 

records fwtmp: fwtmp, wtmpfix: manipulate connect accounting . . fwtmp(ADM) 

/floating-point number into a mantissa and an exponent.frexp(S) 

ascii: Map of the ASCII character set. . . ascii(M) 
mapping, mapehan: Configure tty device . . mapchan(M) 

mapping files, mapehan: Format of tty device . . mapchan(F) 

convkey: Configure monitor/ mapkey, mapsem, mapstr, .... mapkey(M) 

mapehan: Format of tty device mapping files.mapchan(F) 

mapehan: Configure tty device mapping.mapchan(M) 

Configure monitor screen mapping, /mapstr, convkey: . . . mapkey(M) 

usemouse: Maps mouse input to keystrokes . usemouse(C) 
Configure monitor/ mapkey, mapsem, mapstr, convkey: .... mapkey(M) 
monitor screen/ mapkey, mapsem, mapstr, convkey: Configure . . . mapkey(M) 

ev_setemask: Sets event mask.ev_stemsk(S) 

umask: Sets file-creation mode mask.umask(C) 

Return the current event mask, ev_getemask: .ev_gtemsk(S) 

Sets and gets file creation mask, umask:.umask(S) 

assembler, masm: Invokes the XENIX . . . masm(CP) 

Regular expression compile and match routines, regexp:.regexp(S) 

math: math functions and constants . . . math(M) 

constants math: math functions and .... math(M) 

function, matherr: Error-handling.matherr(S) 

limit file, maxuuscheds: UUCP uusched . . maxuuscheds(F) 

limit file, maxuuxqts: UUCP uuxqt .... maxuuxqts(F) 

mdevice: file format.mdevice(F) 

currently specified in the mdevice file /device numbers . . majorsinuse(ADM) 

mem, kmem: Memory image file. . mem(M) 
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mem, kmem: Memory image file.mem(M) 

lock: Locks a process in primary memory.lock(S) 

shmctl: Controls shared memory operations.shmctl(S) 

shmop: Performs shared memory operations.shmop(S) 

shmget: Gets a shared memory segment.shmget(S) 

Reports virtual memory statistics, vmstat: .... vmstat(C) 

realloc, calloc: Allocates main memory, malloc, free, .malloc(S) 

Lock process, text, or data in memory, plock:.plock(S) 

queue, semaphore set or shared memory. /Removes a message . . ipcrm(ADM) 

administration/ atcronsh: Menu driven at and cron .... atcronsh(ADM) 

utility auditsh: Menu driven audit administration . auditsh(ADM) 

administration/ backupsh: Menu driven backup .backupsh(ADM) 

administration utility lpsh: Menu driven lp print service . . . lpsh(ADM) 

administration/ sysadmsh: Menu driven system .sysadmsh(ADM) 

files acctmerg: merge or add total accounting . . acctmerg(ADM) 

sort: Sorts and merges files.sort(C) 

paste: Merges lines of files.paste(C) 

sent to a terminal, mesg: Permits or denies messages . mesg(C) 
msgctl: Provides message control operations. . . . msgctl(S) 

mkstr: Creates an error message file from C source. . . . mkstr(CP) 

msgop: Message operations.msgop(S) 

mailx: interactive message processing system . . . mailx(C) 

msgget: Gets message queue.msgget(S) 

shared memory, ipcrm: Removes a message queue, semaphore set or . ipcrm(ADM) 

hello: Send a message to another user.hello(ADM) 

console messages, messages: Description of system . messages(M) 

dosexterr: Gets DOS error messages.dosexter(DOS) 

mestbl: create a messages locale file .mestbl(M) 

mesg: Permits or denies messages sent to a terminal. . . . mesg(C) 

Description of system console messages, messages:.messages(M) 

Prints STREAMS trace messages strace: .strace(ADM) 

ermo: Sends system error messages. /sys_nerr,.perror(S) 

file mestbl: create a messages locale . mestbl(M) 

(F) mfsys: file format.mfsys 

mfsys: file format.mfsys(F) 

micnet:The Micnet default commands file. . . micnet(F) 

daemon.mn: Micnet mailer daemon.daemon.mn(M) 

mnlist: converts a XENIX-style Micnet routing file to/ .mnlist(ADM) 

file, systemid: The Micnet system identification . . . systemid(F) 

commands file, micnet: The Micnet default . . . micnet(F) 

top, top.next: The Micnet topology files.top(F) 

/- overview of accounting and miscellaneous accounting/ .... acct(ADM) 

/Introduction to machine related miscellaneous features and/ . . . Intro(HW) 

files, intro: Introduction to miscellaneous features and . . . Intro(M) 

mkdir: Creates a new directory. . . mkdir(DOS) 

mkdir: Makes a directory.mkdir(C) 

mkfs: Constructs a file system. . . mkfs(ADM) 
mknod: Builds special files. . . . mknod(C) 

special or ordinary file, mknod: Makes a directory, or a . . mknod(S) 

file from C source, mkstr: Creates an error message . mkstr(CP) 
mktemp: Makes a unique filename. mktemp(S) 
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list: list processor channel for MMDF .list(ADM) 

logs: MMDF logfiles .logs(F) 

deliver: MMDF mail delivery process . . deliver(ADM) 

submit: MMDF mail enqueuer .submit(ADM) 

tables: MMDF Name Tables.tables(F) 

mail in transit queue: MMDF queue files for storing . . queue(ADM) 

generator checkque: MMDF queue status report . . . checkque(ADM) 

over any supported network, mmdf: routes mail locally and . . mmdf(ADM) 

aliases file to MMDF/ mmdfalias: converts XENIX-style . mmdfalias(ADM) 
file to MMDF/ mmdfalias: converts XENDC-style aliases . . mmdfalias(ADM) 

Micnet routing file to/ mnlist: converts a XENDC-style . . mnlist(ADM) 

mnt: Mount a filesystem.mnt(C) 

system table, mnttab: Format of mounted file . . mnttab(F) 

vidi: Sets the font and video mode for a video device.vidi(C) 

umask: Sets file-creation mode mask.umask(C) 

chmod: Changes mode of a file.chmod(S) 

kbmode: Set keyboard mode or test keyboard support . . kbmode(ADM) 

setmode: Sets translation mode.setmode(DOS) 

sulogin: access single-user mode .sulogin(ADM) 

dial: Dials a modem.dial(ADM) 

uuchat: dials a modem.dial(ADM) 

getty: Sets terminal type, modes, speed, and line/.getty(M) 

uugetty: set terminal type, modes, speed, and line/.uugetty(ADM) 

tset: Sets terminal modes.tset(C) 

number into a/ frexp, ldexp, modf: Splits floating-point .... frexp(S) 

settime: Changes the access and modification dates of files.settime(ADM) 

touch: Updates access and modification times of a file. . . . touch(C) 

utime: Sets file access and modification times.utime(S) 

/produces a list of the software modifications to the system . . . swconfig(C) 

entry points in a driver object module, routines: finds driver . . routines(ADM) 

Relocatable Format for Object Modules. 86rel: Intel 8086 . . . 86rel(F) 

/ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp,/ . . . acctsh(ADM) 

profile, monitor: Prepares execution . . . monitor(S) 

Anapstr, convkey: Configure monitor screen mapping.mapkey(M) 

uusub: Monitor uucp network.uusub(C) 

tty [01-«], color, monochrome, ega,. screen: . . . screen(HW) 

mnt: Mount a filesystem.mnt(C) 

fstab: File system mount and check commands. . . . fstab(F) 

mount: Mounts a file structure. . . mount(ADM) 

mount: Mounts a file system. . . . mount(S) 

mountall: mountall, umountall - mount, unmount multiple file/ . . mountall(ADM) 

mountall: mountall, umountall mount, unmount multiple file/ . . mountall(ADM) 

mount, unmount multiple file/ mountall: mountall, umountall - . . mountall(ADM) 

unmount multiple file/ mountall: mountall, umountall - mount, . . . mountall(ADM) 

mnttab: Format of mounted file system table.mnttab(F) 

/Default information for mounting filesystems.filesys(F) 

mount: Mounts a file structure.mount(ADM) 

mount: Mounts a file system.mount(S) 

usemouse: Maps mouse input to keystrokes .... usemouse(C) 

mouse: System mouse.mouse(HW) 

mouse: System mouse.mouse(HW) 
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specific address, movedata: Copies bytes from a . . movedata(DOS) 

mvdir: Moves a directory.mvdir(C) 

directories, mv: Moves or renames files and . . . mv(C) 
lseek: Moves read/write file pointer. . . lseek(S) 
utility mscreen: Serial multiscreens . . . mscreen(M) 

dosld: XENIX to MS-DOS cross linker.dosld(CP) 

msg: read mail .msg(C) 

operations, msgctl: Provides message control . msgctl(S) 
msgget: Gets message queue. . . . msgget(S) 
msgop: Message operations. . . . msgop(S) 

mtune: file format.mtune(F) 

umountall - mount, unmount multiple file systems /mountall, . mountall(ADM) 
used by x t (7)/ xtproto: multiplexed channels protocol . . xtproto(M) 
windowing terminals xt: multiplexed tty driver for AT&T . xt(HW) 
terminals layers: layer multiplexer for windowing .... layers(C) 

select: synchronous I/O multiplexing.select(S) 

mscreen: Serial multiscreens utility.mscreen(M) 

rc2: run commands performed for multiuser environment .rc2(ADM) 

directories, mv: Moves or renames files and . . mv(C) 

mvdir: Moves a directory.mvdir(C) 

devnm: Identifies device name.devnm(C) 

getlogin: Gets login name.getlogin(S) 

logname: Gets login name.logname(C) 

pwd: Prints working directory name.pwd(C) 

tty: Gets the terminal’s name.tty(C) 

Gets value for environment name, getenv: .getenv(S) 

ncheck: Generates names from inode numbers. . . . ncheck(ADM) 

basename: Removes directory names from pathnames.basename(C) 

archive, dumpdir: Prints the names of files on a backup .... dumpdir(C) 

Prints user and group IDs and names, id: .id(C) 

short interval, nap: Suspends execution for a . . nap(S) 

access to a resource/ waitsem, nbwaitsem: Awaits and checks . . waitsem(S) 

inode numbers, ncheck: Generates names from . . ncheck(ADM) 

network, netutil: Administers the XENIX . . netutil(ADM) 

administration nlsadmin: network listener service.nlsadmin(ADM) 

netutil: Administers the XENIX network.netutil(ADM) 

uusub: Monitor uucp network.uusub(C) 

locally and over any supported network, mmdf: routes mail . . . mmdf(ADM) 

text file, newform: Changes the format of a . newform(C) 
group, newgrp: Logs user into a new . . newgrp(C) 

news: Print news items.news(C) 

news: Print news items.news(C) 

/fetch, store, delete, firstkey, nextkey: Performs database/ . . . dbm(S) 

tables nictable: process NIC database into channel/domain nictable(ADM) 
process, nice: Changes priority of a .... nice(S) 
different priority, nice: Runs a command at a ... nice(C) 
into channel/domain tables nictable: process NIC database . . nictable(ADM) 

nl: Adds line numbers to a file. . . nl(C) 

list, nlist: Gets entries from name . . . nlist(S) 
service administration nlsadmin: network listener .... nlsadmin(ADM) 
nm: Prints name list.nm(CP) 
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hangups and quits, nohup: Runs a command immune to 

setjmp, longjmp: Performs a nonlocal “goto”. . 

goodpw: Check a password for non-obviousness. 

false: Returns with a nonzero exit value. 

Terminal driving tables for nroff. term:. 

null: The null file. 

null: The null file. 

/dodisk, lastlogin, monacct, nulladm, prctmp, prdaily,/ . . . . 

factor: Factor a number. 

random: Generates a random number. 

rand, srand: Generates a random number. 

the/ /the list of major device numbers currently specified in . . 

nl: Adds line numbers to a file. 

ultoa: Converts numbers to characters. 

itoa: Converts numbers to integers. 

atoi, atol: Converts ASCII to numbers, atof, . 

Generates names from inode numbers, ncheck: . 

library routines and error numbers, /system services, . . . 

a string to a double-precision number, strtod, atof: Converts . . 

numtbl: Create a numeric locale table. 

table, numtbl: Create a numeric locale 
DMD terminal wtinit: object downloader for the 5620 . . 

ldfcn: common object file access routines .... 

size: Prints the size of an object file. 

syms: common object file symbol table format . . 

line number entries in a common object file linenum: . 

information for a common object file reloc: relocation . . . 

filehdr: file header for common object files. 

section header for a common object file scnhdr:. 

the printable strings in an object file, strings: Finds .... 

Finds ordering relation for an object library, lorder:. 

driver entry points in a driver object module, routines: finds . . 

8086 Relocatable Format for Object Modules. 86rel: Intel . . . 

a process until a signal occurs, pause: Suspends .... 

od: Displays files in octal format. 

format, od: Displays files in octal .... 

fp_off, fp_seg: Return oflset and segment. 

Invokes a restricted version of. red: . 

new file or rewrites an existing one. creat: Creates a. 

and writing, sopen: Opens a file for shared reading . . 

opensem: Opens a semaphore. 

fopen, freopen, fdopen: Opens a stream. 

ev_open: Opens an event queue for input. . . 

writing, open: Opens file for reading or. 

opensem: Opens a semaphore. . . 
prf: operating system profiler . . . . 
commands performed to stop the operating system rcO: run .... 

closedir: Performs directory operations. 

msgctl: Provides message control operations. 

msgop: Message operations. 

semctl: Controls semaphore operations. 


nohup(C) 

setjmp(S) 

goodpw(ADM) 

false(C) 

term(F) 

null(F) 

null(F) 

acctsh(ADM) 

factor(C) 

random(C) 

rand(S) 

majorsinuse(ADM) 

nl(C) 

ultoa(DOS) 

itoa(DOS) 

atof(S) 

ncheck(ADM) 

Intro(S) 

strtod(S) 

numtbl(M) 

numtbl(M) 

wtinit(ADM) 

ldfcn(F) 

size(CP) 

syms(F) 

linenum(F) 

reloc(F) 

filehdr(F) 

scnhdr(F) 

strings(CP) 

lorder(CP) 

routines(ADM) 

86rel(F) 

pause(S) 

od(C) 

od(C) 

fp_seg(DOS) 

red(C) 

creat(S) 

sopen(DOS) 

opensem(S) 

fopen(S) 

ev_open(S) 

open(S) 

opensem(S) 

prf(HW) 

rcO(ADM) 

directory(S) 

msgctl(S) 

msgop(S) 

semctl(S) 
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semop: Performs semaphore operations. 

shmctl: Controls shared memory operations. 

shmop: Performs shared memory operations. 

strdup: Performs string operations. 

vector, getopt: Gets option letter from argument . . . 

fcntl: file control options .. 

stty: Sets the options for a terminal. 

getopt: Parses command options. 

getoptcvt - parse command options getopts: getopts, .... 

library, lorder: Finds ordering relation for an object . . 
a directory, or a special or ordinary file, mknod: Makes . . . 

Copies file archives in and out. cpio: . 

dial: Establishes an out-going terminal line/. 

port, outp: Writes a byte to an output . . 

flushall: Flushes all output buffers. 

ecvt, fcvt, gcvt: Performs output conversions. 

cprintf: Formats output. 

error: Kernel error output device. 

tapedump: Dumps magnetic tape to output file. 

/vsprintf: Prints formatted output of a varargsj . 

outp: Writes a byte to an output port. 

pr: Prints files on the standard output. 

parameters sysdef: output values of tunable. 

of assembler and link editor output. a.out: Format. 

buffered binary input and output, fread, fwrite: Performs . . 

fprintf, sprintf: Formats output, printf,. 

standard buffered input and output, stdio: Performs. 

/acctdusg, accton, acctwtmp - overview of accounting and/ . . . 
/acctdusg, accton, acctwtmp overview of accounting and/ . . . 

purge: overwrites specified files .... 

chown: Changes the owner and group of a file. 

chown: Changes owner ID. 

quot: Summarizes file system ownership. 

and expands files, pack, peat, unpack: Compresses 

installpkg: install package . 

removepkg: remove installed package . 

interprocess communication package, ftok: Standard. 

displaypkg: display installed packages. 

sadc - system activity report package sar: sar, sal, sa2, . . . . 

xtt: extract and print xt driver packet traces . 

terminal 4014: paginator for the TEKTRONIX 4014 
to set value of a tunable parameter idtune: attempts . . . 

sysdef: output values of tunable parameters . 

Gets process, process group, and parent process IDs. /getppid: . . . 

getopts: getopts, getoptcvt - parse command options. 

getopts: getopts, getoptcvt parse command options. 

getopt: Parses command options. 

fdisk: Maintain disk partitions. 

files, hdr: Displays selected parts of executable binary .... 

dialup shell password, passwd: Change login, group, or 

passwd: The password file. . . . 


semop(S) 
shmctl(S) 
shmop(S) 
string(S) 
getopt(S) 
fcntl(M) 
stty(C) 
getopt(C) 
getopts(C) 
lorder(CP) 
mknod(S) 
cpio(C) 
dial(S) 
outp(DOS) 
flushall(DOS) 
ecvt(S) 
cprintf(DOS) 
error(M) 
tapedump(C) 
vprintf(S) 
outp(DOS) 
pr(C) 

sysdef(ADM) 
a.out(F) 
fread(S) 
printf(S) 
stdio(S) 
acct(ADM) 
acct(ADM) 
purge(C) 
chown(S) 
chown(C) 
quot(C) 
pack(C) 
installpkg(ADM) 
removepkg(ADM) 
stdipc(S) 

displaypkg(ADM) 
sar(ADM) 
xtt(ADM) 

4014(C) 
idtune(ADM) 
sysdef(ADM) 
getpid(S) 
getopts(C) 
getopts(C) 
getopt(C) 
fdisk(ADM) 
hdr(CP) 
passwd(C) 
passwd(F) 
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putpwent: Writes a 
setpwent, endpwent: Gets 
passwd: The 
pwcheck: Checks 
getpw: Gets 
goodpw: Check a 
getpass: Reads a 
login, group, or dialup shell 

directory, getcwd: Get the 
Delivers directory part of 
Removes directory names from 
Searches for and processes a 
fgrep: Searches a file for a 
a signal occurs. 

keyboard: The 
expands files, pack, 
a process, popen, 
reduction reduce: 
environment rc2: run commands 
system rcO: run commands 
bsearch: 
setjmp, longjmp 
qsort 

floor, fabs, ceil, fmod 
bessel, jO, j 1, jn, yO, y 1, yn 
and output, ffead, fwrite 
/delete, firstkey, nextkey 
closedir 

exp, log, pow, sqrt, log 10 
sinh, cosh, tanh 
backup, backup 
update, lsearch, lfind 
gamma 
ecvt, fcvt, gcvt 
system backups fsphoto 
functions backup 
incremental filesystem/ xbackup 
functions, curses 
semop 
operations, shmop 
and output, stdio 
strdup 

/tgetflag, tgetstr, tgoto, tputs 
tan, asin, acos, atan, atan2 
backups fsphoto: Performs 
permissions: Format of UUCP 
check the uucp directories and 
Permissions file, 
chmod: Changes the access 


password file entry. 

password file entry, /getpwnam, 

password file. 

password file. 

password for a given user ID. . . 
password for non-obviousness. 

password. 

password, passwd: Change . . 
paste: Merges lines of files. . . 
pathname of current working . . 

pathname, dimame: . 

pathnames, basename: . . . . 

pattern in a file, awk:. 

pattern, grep, egrep, . 

pause: Suspends a process until . 
pax: portable archive exchange . 

PC keyboard. 

peat, unpack: Compresses and 
pclose: Initiates I/O to or from 
perform audit data analysis and . 
performed for multiuser .... 
performed to stop the operating . 
Performs a binary search. . . . 
Performs a nonlocal “goto”. . . 

Performs a quicker sort. 

Performs absolute value, floor,/ . 
Performs Bessel functions. . . . 
Performs buffered binary input 
Performs database functions. . . 
Performs directory operations. 
Performs exponential, logarithm,/ 
Performs hyperbolic functions. 
Performs incremental file system 
Performs linear search and . . . 
Performs log gamma function. 
Performs output conversions. . . 
Performs periodic semi-automated 
performs UNIX backup . . . . 

Performs XENIX. 

Performs screen and cursor . . 
Performs semaphore operations. 
Performs shared memory . . . 
Performs standard buffered input 
Performs string operations. . . . 
Performs terminal functions. . . 
Performs trigonometric/ /cos, 
periodic semi-automated system 

Permissions file. 

permissions file uucheck: . . . 
permissions: Format of UUCP 
permissions of a file or/ .... 


putpwent(S) 

getpwent(S) 

passwd(F) 

pwcheck(C) 

getpw(S) 

goodpw(ADM) 

getpass(S) 

passwd(C) 

paste(C) 

getcwd(S) 

dimame(C) 

basename(C) 

awk(C) 

grep(C) 

pause(S) 

pax(C) 

keyboard(HW) 

pack(C) 

popen(S) 

reduce(ADM) 

rc2(ADM) 

rcO(ADM) 

bsearch(S) 

setjmp(S) 

qsort(S) 

floor(S) 

bessel(S) 

fread(S) 

dbm(S) 

directory(S) 

exp(S) 

sinh(S) 

backup(ADM) 

lsearch(S) 

gamma(S) 

ecvt(S) 

fsphoto(ADM) 

backup(ADM) 

xbackup(ADM) 

curses(S) 

semop(S) 

shmop(S) 

stdio(S) 

string(S) 

termcap(S) 

trig(S) 

fsphoto(ADM) 

permissions(F) 

uucheck(ADM) 

permissions(F) 

chmod(C) 
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to a terminal, mesg: 
acct: Format of 
acctcms: command summary from 
ermo: Sends system error/ 
split: Splits a file into 

Pipe- 

pipe: Creates an interprocess 
tee: Creates a tee in a 
data in memory. 

images 

rewind: Repositions a file 
lseek: Moves read/write file 
the current position of the file 
routines: finds driver entry 
utility purge(C) purge: the 
poll: Format of UUCP 

queue. ev_pop: 
or from a process, 
outp: Writes a byte to an output 
pax: 

, tty2[A-H]: Interface to serial 
exponential,/ exp, log, 
/Performs exponential, logarithm, 
output. 

/lastlogin, monacct, nulladm, 
/monacct, nulladm, prctmp, 
dc: Invokes an arbitrary 
monitor: 
cpp: The C language 
unget: Undoes a 

profiler: prfld, prfstat, 
/prfld, prfstat, prfdc, prfsnap, 
profiler: prfld, prfstat, prfdc, 
-/ profiler: prfld, 
lock: Locks a process in 
graphical files gps: graphical 
types: 

temporarily privs: 
to a serial/ consoleprint: 

news: 

infocmp: compare or 
utility lpsh: Menu driven lp 
filters used with the LP 
forms used with the LP 
jwin: 

the user’s terminal lprint: 

and names id: 
xtt: extract and 


Permits or denies messages sent 
per-process accounting file, 
per-process accounting records 
perror, sys_errlist, sys_nerr, 

pieces. 

pipe: Creates an interprocess 

Pipe. 

Pipe. 

plock: Lock process, text, or 
plot: graphics interface . . 
pnch: file format for card 
pointer in a stream, /ftell, 

pointer. 

pointer, tell: Gets .... 
points in a driver object/ . . 
policy file of the sanitization 

Poll file. 

poll: Format of UUCP Poll file. 
Pop the next event off the 
popen, pclose: Initiates I/O to 

port. 

portable archive exchange . 
ports. /,ttyl[A-H] ,tty2[a-h] 
pow, sqrt, log 10: Performs . 
power, square root functions, 
pr: Prints files on the standard 
prctmp, prdaily, prtacct,/ 
prdaily, prtacct, runacct,/ 
precision calculator. . . . 
Prepares execution profile. . 

preprocessor. 

previous get of an SCCS file, 
prf: operating system profiler 
prfdc, prfsnap, prfpr -/ . . 

prfpr - UNIX system/ . . . 
prfsnap, prfpr - UNIX/ . . . 
prfstat, prfdc, prfsnap, prfpr 

primary memory. 

primitive string, format of . 
Primitive system data types, 
print and/or restrict privileges 
Print file to printer attached 

Print news items. 

print out terminfo descriptions 
print service administration 
print service /administer 
print service /administer 
print size of layer .... 
Print to a printer attached to 
print user and group IDs . . 
print xt driver packet traces 


mesg(C) 
acct(F) 

acctcms(ADM) 
perror(S) 
split(C) 
pipe(S) 
pipe(S) 
tee(C) 
plock(S) 
plot(F) 
pnch(F) 
fseek(S) 
lseek(S) 
tell(DOS) 
routines(ADM) 
purge(F) 
poll(F) 
poll(F) 
ev_pop(S) 
popen(S) 
outp(DOS) 
pax(C) 
serial(HW) 
exp(S) 
exp(S) 
pr(C) 

acctsh(ADM) 
acctsh(ADM) 
dc(C) 
monitor(S) 
cpp(CP) 
unget(CP) 
prf(HW) 
profiler(ADM) 
profiler(ADM) 
profiler(ADM) 
profiler(ADM) 
lock(S) 
gps(F) 
types(F) 
privs(C) 

consoleprint(ADM) 
news(C) 
infocmp(ADM) 
lpsh(ADM) 
lpfilter(ADM) 
lpforms(ADM) 
jwin(C) 
lprint(C) 
id(ADM) 
xtt(ADM) 
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xts: extract and print xt driver statistics .xts(ADM) 

file, strings: Finds the printable strings in an object . . . strings(CP) 

consoleprint: Print file to printer attached to a serial/ .... consoleprint(ADM) 
terminal lprint: Print to a printer attached to the user’s . . . lprint(C) 

lp, lpO, lpl, lp2: Line printer device interfaces.lp(HW) 

/imagen.remote: IMAGEN printer interface scripts.imagen(M) 

Prints text files on an IMAGEN printer, imprint:.imprint(C) 

disable: Turns off terminals and printers.disable(C) 

T\ims on terminals and line printers, enable:.enable(C) 

Formats output, printf, fprintf, sprintf:.printf(S) 

lpusers: set printing queue priorities.lpusers(ADM) 

cal: Prints a calendar.cal(C) 

prs: Rints an SCCS file.prs(CP) 

sddate: Prints and sets backup dates. . . . sddate(C) 

date: Prints and sets the date.date(C) 

activity, sact: Prints current SCCS file editing . . sact(CP) 

output, pr: Prints files on the standard .... pr(C) 

vprintf, vfprintf, vsprintf: Prints formatted output of a/ . . . vprintf(S) 

banner: Prints large letters.banner(C) 

information, lpstat: prints lineprinter status .lpstat(C) 

nm: Prints name list.nm(CP) 

file system fsname: Prints or changes the name of a . . fsname(ADM) 
acctcom: Searches for and prints process accounting files. . . acctcom(ADM) 

messages strace: Prints STREAMS trace .strace(ADM) 

yes: Prints string repeatedly.yes(C) 

printer, imprint: Prints text files on an IMAGEN . . imprint(C) 

stream, head: Prints the first few lines of a ... head(C) 

UNIX system, uname: Prints the name of the current . . uname(C) 

backup archive, dumpdir: Prints the names of files on a ... dumpdir(C) 
file, size: Prints the size of an object .... size(CP) 
names, id: Prints user and group IDs and . . id(C) 

pwd: Frints working directory name. . . pwd(C) 

lpusers: set printing queue priorities.lpusers(ADM) 

nice: Changes priority of a process.nice(S) 

Runs a command at a different priority, nice:.nice(C) 

privs: print and/or restrict privileges temporarily .privs(C) 

privileges temporarily privs: print and/or restrict .... privs(C) 

/startup, tumacct - shell procedures for accounting .... acctsh(ADM) 

- system initialization procedures brc: brc, bcheckrc . . brc(ADM) 

acctprc: acctprcl, acctprc2 - process accounting.acctprc(ADM) 

acctprc: acctprcl, acctprc2 process accounting.acctprc(ADM) 

acct: Enables or disables process accounting.acct(S) 

acctcom: Searches for and prints process accounting files.acctcom(ADM) 

alarm: Sets a process’ alarm clock.alarm(S) 

times: Gets process and child process times. . times(S) 

init, inir: F’rocess control initialization. . . . init(M) 

timex: time a command; report process data and system activity . timex(ADM) 

deliver: MMDF mail delivery process .deliver(ADM) 

exit: Terminates the calling process.exit(DOS) 

exit, _exit: Terminates a process.exit(S) 

fork: Creates a new process.fork(S) 
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/getpgrp, getppid: Gets process, process group, and parent/ .... getpid(S) 

setpgrp: Sets process group ID.setpgrp(S) 

process group, and parent process IDs. /Gets process, . . . getpid(S) 

lock: Locks a process in primary memory. . . . lock(S) 

kill: Terminates a process.kill(C) 

channel/domain tables nictable: process NIC database into .... nictable(ADM) 

nice: Changes priority of a process.nice(S) 

kill: Sends a signal to a process or a group of processes. . . kill(S) 

getpid, getpgrp, getppid: Gets process, process group, and/ . . . getpid(S) 

ptrace: Traces a process.ptrace(S) 

spawnl, spawnvp: Creates a new process.spawn(DOS) 

ps: Reports process status.ps(C) 

memory. plock:Lock process, text, or data in .plock(S) 

times: Gets process and child process times.times(S) 

wait: Waits for a child process to st<j>p or terminate. . . . wait(S) 

pause: Suspends a process until a signal occurs. . . . pause(S) 

sigsem: Signals a process waiting on a semaphore. . sigsem(S) 

checklist: List of file systems processed by fsck .checklist(F) 

awk: Searches for and processes a pattern in a file. . . . awk(C) 

killall: kill all active processes .killall(ADM) 

to a process or a group of processes, kill: Sends a signal . . kill(S) 

Awaits completion of background processes, wait:.wait(C) 

shutdown: Terminates all processing.shutdown(ADM) 

mailx: interactive message processing system .mailx(C) 

list: list processor channel for MMDF . . list(ADM) 

m4: Invokes a macro processor.m4(CP) 

machid: machid, i386 - get processor type truth value .... machid(C) 

Initiates I/O to or from a process, popen, pclose:.popen(S) 

subsystem events dlvr_audit: produce audit records for .... dlvr_audit(ADM) 
modifications to the/ swconfig: produces a list of the software . . swconfig(C) 

prof: Displays profile data.prof(CP) 

prof: profile within a function . . prof(M) 
time profile, profil: Creates an execution . . . profil(S) 

prof: Displays profile data.prof(CP) 

monitor: Prepares execution profile.monitor(S) 

at login time, profile: Sets up an environment . . profile(M) 

prof: profile within a function.prof(M) 

Creates an execution time profile, profil:.profil(S) 

prf: operating system profiler .prf(HW) 

prfsnap, prfpr - UNIX/ profiler: prfld, prfstat, prfdc, . . . profiler(ADM) 

prfpr-UNIX/ profiler: prfld, prfstat, prfdc, prfsnap, . . . profiler(ADM) 

assert: Helps verify validity of program.assert(S) 

boot: XENIX boot program.boot(HW) 

tape: Magnetic tape maintenance program.tape(C) 

etext, edata: Last locations in program, end,.end(S) 

cb: Beautifies C programs.cb(CP) 

lex: Generates programs for lexical analysis. . . lex(CP) 

xref: Cross-references C programs.xref(CP) 

xstr: Extracts strings from C programs.xstr(CP) 

and regenerates groups of programs. /Maintains, updates, . . make(CP) 

domain of a program promain: restrict the execution . . promain(M) 
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day. asktime: Prompts for the correct time of . . asktime(ADM) 
proto: prototype job file for at . . proto(ADM) 
windowing terminal/ layers: protocol used between host and . . layers(M) 

xtproto: multiplexed channels protocol used by x t (7)/ .... xtproto(M) 

proto: prototype job file for at .proto(ADM) 

labelit: provide labels for file systems . . labelit(ADM) 

locking on files, lockf: Provide semaphores and record . . lockf(S) 

operations, msgctl: Provides message control .... msgctl(S) 

prs: Prints an SCCS file.prs(CP) 

Aiulladm, prctmp, prdaily, prtacct, runacct, shutacct,/ .... acctsh(ADM) 

ps: Reports process status.ps(C) 

sxt: Pseudo-device driver.sxt(M) 

information, pstat: Reports system.pstat(C) 

ptrace: Traces a process.ptrace(S) 

files purge: overwrites specified . . . purge(C) 

sanitization utility purge(C) purge: the policy file of the ... purge(F) 
file of the sanitization utility purge(C) purge: the policy . . . purge(F) 

stream, ungetc: Pushes character back into input . ungetc(S) 

a character or word on a/ putc, putchar, fputc, putw: Puts . . putc(S) 

console, putch: Writes a character to the . . putch(DOS) 

character or word on a/ putc, putchar, fputc, putw: Puts a ... putc(S) 

environment, putenv: Changes or adds value to . putenv(S) 

entry, putpwent: Writes a password file . putpwent(S) 

putc, putchar, fputc, putw: Puts a character or word on a/ . . putc(S) 

puts, fputs: Puts a string on a stream.puts(S) 

cputs: Puts a string to the console. . . . cputs(DOS) 

stream, puts, fputs: Puts a string on a ... puts(S) 

on a/ putc, putchar, fputc, putw: Puts a character or word . . putc(S) 

pwcheck: Checks password file. . pwcheck(C) 
name, pwd: Prints working directory . . pwd(C) 

tapecntl: AT&T tape control for QIC-24/QIC-02 tape device . . . tapecntl(C) 

qsort: Performs a quicker sort. . . qsort(S) 

tput: Queries the terminfo database. . . tput(C) 

ev_close: Close the event queue and all associated/ .... ev_close(S) 

ev_block: Wait until the queue contains an event.ev_block(S) 

ev_resume: Restart a suspended queue.ev_resume(S) 

ev_suspend: Suspends an event queue.ev_susp(S) 

transit queue: MMDF queue files for storing mail in . . . queue(ADM) 

ev_open: Opens an event queue for input.ev_open(S) 

storing mail in transit queue: MMDF queue files for . . queue(ADM) 

msgget: Gets message queue.msgget(S) 

lpusers: set printing queue priorities .lpusers(ADM) 

ipcrm: Removes a message queue, semaphore set or shared/ . ipcrm(ADM) 

checkque: MMDF queue status report generator . . . checkque(ADM) 

all events currently in the queue. ev_flush: Discard .... ev_flush(S) 

list of devices feeding an event queue. ev_getdev: Gets a .... ev_getdev(S) 

Pop the next event off the queue. ev_pop: .ev_pop(S) 

Read the next event in the queue. ev_read:.ev_read(S) 

of events currently in the queue. /Returns the number . . . ev_count(S) 

qsort: Performs a quicker sort.qsort(S) 

a command immune to hangups and quits, nohup: Runs.nohup(C) 
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ownership. 

number. 

number. 

ranlib: Converts archives to 
random: Generates a 
rand, srand: Generates a 
random libraries. 

FORTRAN into standard FORTRAN. 
FORTRAN, ratfor: Converts 
stop the operating system 
multiuser environment 
systems, 
data to be read, 
generated by the audit/ auditd: 

in a file, getdents: 
specifications idmkinit: 
setlocale: Set or 
msg: 

information, hwconfig: 
queue. ev_read: 
sopen: Opens a file for shared 
open: Opens file for 
or unlocks a file region for 
to see if there is data to be 
getpass: 
defopen, deffead: 

read: 
line: 
mail: Sends, 
lseek: Moves 
memory. malloc,free, 
getclk: gets string from 
clock: The system 
setclock: Sets the system 
systems and shuts down/ haltsys. 
Specifies what to do upon 
rmail: submit remote mail 
lineprinters. lpinit: Adds, 
lockf: Provide semaphores and 
dlvr_audit: produce audit 
from per-process accounting 
manipulate connect accounting 
version of. 
analysis and reduction 
perform audit data analysis and 
regular expressions, regex, 
expressions, 
make: Maintains, updates, and 
executes regular expressions, 
compile and match routines. 


quot: Summarizes file system . . . 
rand, srand: Generates a random 
random: Generates a random . . . 

random libraries. 

random number. 

random number. 

ranlib: Converts archives to ... 
ratfor: Converts Rational .... 
Rational FORTRAN into standard . 
rcO: run commands performed to 
rc2: run commands performed for . 
rep: Copies files across XENIX . . 
rdchk: Checks to see if there is . . 
read audit collection files .... 
read directory entries and put . . . 

read files containing . 

read international environment . . 

read mail. 

read: Reads from a file. 

Read the configuration . 

Read the next event in the .... 

reading and writing. 

reading or writing. 

reading or writing. /Locks . . . . 

read, rdchk: Checks . 

Reads a password. 

Reads default entries. 

Reads from a file. 

Reads one line. 

reads or disposes of mail. 

read/write file pointer. 

realloc, calloc: Allocates main . . 

real-time clock . 

real-time (time of day) clock. . . . 
real-time (time of day) clock. . . . 
reboot: Closes out the file .... 
receipt of a signal, signal: .... 

received via UUCP. 

reconfigures and maintains .... 

record locking on files. 

records for subsystem events . . . 
records /command summary . . . 
records fwtmp: fwtmp, wtmpfix: 

red: Invokes a restricted. 

reduce: perform audit data .... 

reduction reduce: . 

regemp: Compiles and executes . . 
regemp: Compiles regular .... 
regenerates groups of programs, 
regex, regemp: Compiles and . . . 
regexp: Regular expression . . . 


quot(C) 

rand(S) 

random(C) 

ranlib(CP) 

random(C) 

rand(S) 

ranlib(CP) 

ratfor(CP) 

ratfor(CP) 

rcO(ADM) 

rc2(ADM) 

rcp(C) 

rdchk(S) 

auditd(ADM) 

getdents(S) 

idmkinit(ADM) 

setlocale(S) 

msg(C) 

read(S) 

hwconfig(ADM) 

ev_read(S) 

sopen(DOS) 

open(S) 

locking(S) 

rdchk(S) 

getpass(S) 

defopen(S) 

read(S) 

line(C) 

mail(C) 

lseek(S) 

malloc(S) 

getclk(M) 

clock(F) 

setclock(ADM) 

haltsys(ADM) 

signal(S) 

rmail(ADM) 

lpinit(ADM) 

lockf(S) 

dlvr_audit(ADM) 
acctcms(ADM) 
fwtmp(ADM) 
red(C) 

reduce(ADM) 
reduce(ADM) 
regex(S) 
regcmp(CP) 
make(CP) 
regex(S) 
regexp(S) 
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execseg: makes a data region executable.execseg(S) 

locking: Locks or unlocks a file region for reading or writing. . . . locking(S) 

match routines, regexp: Regular expression compile and . regexp(S) 

regcmp: Compiles regular expressions.regcmp(CP) 

regcmp: Compiles and executes regular expressions, regex, . . . regex(S) 

sorted files, comm: Selects or rejects lines common to two . . . comm(C) 

intro: Introduction to machine related miscellaneous features/ . . Intro(HW) 

lorder: Finds ordering relation for an object library. . . . lorder(CP) 

join: Joins two relations.join(C) 

for a common object file reloc: relocation information . . . reloc(F) 

Modules. 86rel: Intel 8086 Relocatable Format for Object . . 86rel(F) 

strip: Removes symbols and relocation bits.strip(CP) 

common object file reloc: relocation information for a ... reloc(F) 

show current layer relogin: rename login entry to . . relogin(ADM) 

value, floor, ceiling and remainder functions, /absolute . . floor(S) 

calendar: Invokes a reminder service.calendar(C) 

remote XENIX system, remote: Executes commands on a . remote(C) 

rmail: submit remote mail received via UUCP . rmail(ADM) 

uutry: try to contact remote system with debugging on . uutry(ADM) 

ct: spawn getty to a remote terminal.ct(C) 

remote: Executes commands on a remote XENIX system.remote(C) 

uux: Executes command on remote XENIX.uux(C) 

file rmb: remove extra blank lines from a . . rmb(M) 

removepkg: remove installed package .... removepkg(ADM) 

directories specified cleantmp: remove temporary files in .... cleantmp(ADM) 

package removepkg: remove installed . . . removepkg(ADM) 
file, rmdel: Removes a delta from an SCCS . . rmdel(CP) 

semaphore set or shared/ ipcrm: Removes a message queue, . . . ipcrm(ADM) 

rmdir: Removes directories.rmdir(C) 

unlink: Removes directory entry.unlink(S) 

pathnames, basename: Removes directory names from . . basename(C) 

rm, rmdir: Removes files or directories. . . . rm(C) 

bits, strip: Removes symbols and relocation . strip(CP) 
current layer relogin: rename login entry to show . . . relogin(ADM) 

directory, rename: renames a file or .... rename(DOS) 

rename: renames a file or directory.rename(DOS) 

mv: Moves or renames files and directories. . . . mv(C) 

fsck: Checks and repairs file systems.fsck(ADM) 

uniq: Reports repeated lines in a file.uniq(C) 

yes: Prints string repeatedly.yes(C) 

fsstat: report file system status.fsstat(ADM) 

checkque: MMDF queue status report generator.checkque(ADM) 

blocks, df: Report number of free disk .... df(C) 

sa2, sadc - system activity report package sar: sar, sal, . . . sar(ADM) 

activity timex: time a command; report process data and system . . timex(ADM) 

Generate an IMAGEN accounting report, imacct: .imacct(C) 

clock: Reports CPU time used.clock(S) 

cmchk: Reports hard disk block size. . . . cmchk(C) 

ps: Reports process status.ps(C) 

file, uniq: Reports repeated lines in a .... uniq(C) 

pstat: Reports system information. . . . pstat(C) 
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inter-process/ ipcs: Reports the status of .ipcs(ADM) 

vmstat: Reports virtual memory statistics. . vmstat(C) 
stream, fseek, ftell, rewind: Repositions a file pointer in a . . . fseek(S) 

Starts/stops the lineprinter request, /lpshut, lpmove: .... lpsched(ADM) 

lp, cancel: Send/cancel requests to lineprinter.lp(C) 

terminal jterm: reset layer of windowing .... jterm(C) 

/Awaits and checks access to a resource governed by a/.waitsem(S) 

ev_resume: Restart a suspended queue. . . . ev_resume(S) 

incremental file/ restore, restor: Invokes .restore(ADM) 

incremental filesystem backup/ restore: AT&T UNIX.restore(ADM) 

Invokes incremental file system/ restore, restor:.restore(ADM) 

incremental filesystem backup restore /AT&T UNIX.restore(ADM) 

incremental file system restorer. /Invokes XENIX .... xrestore(ADM) 

Invokes incremental file system restorer, /restor:.restore(ADM) 

privs: print and/or restrict privileges temporarily . . privs(C) 

a program promain: restrict the execution domain of . . promain(M) 

interpreter), rsh: Invokes a restricted shell (command .... rsh(C) 

red: Invokes a restricted version of. .red(C) 

fp_off, fp_seg: Return oflset and segment.fp_seg(DOS) 

ev_getemask: Return the current event mask. . . ev_gtemsk(S) 

ismpx: return windowing terminal state . ismpx(C) 
stat: Data returned by stat system call. . . . stat(F) 

inp: Returns a byte.inp(DOS) 

console buffer, ungetch: Returns a character to the .... ungetch(DOS) 
value, abs: Returns an integer absolute . . . abs(S) 

idcheck: returns selected information . . . idcheck(ADM) 
long integer, labs: Returns the absolute value of a . . labs(DOS) 

strlen: Returns the length of a string. . . strlen(DOS) 

currently in the/ ev_count: Returns the number of events . . . ev_count(S) 

value, false: Returns with a nonzero exit . . . false(C) 

true: Returns with a zero exit value. . . true(C) 

col: Filters reverse linefeeds.col(C) 

in a string, strrev: Reverses the order of characters . strrev(DOS) 

pointer in a/ fseek, ftell, rewind: Repositions a file .... fseek(S) 

creat: Creates a new file or rewrites an existing one.creat(S) 

directories, rm, rmdir: Removes files or ... rm(C) 

received via UUCP rmail: submit remote mail .... rmail(ADM) 
from a file rmb: remove extra blank lines . . rmb(M) 

SCCS file, rmdel: Removes a delta from an . rmdel(CP) 

rmdir: Deletes a directory.rmdir(DOS) 

rmdir: Removes directories. . . . rmdir(C) 

directories, rm, rmdir: Removes files or.rm(C) 

chroot: Changes the root directory.chroot(S) 

chroot: Changes root directory for command. . . . chroot(ADM) 

logarithm, power, square root functions, /exponential, . . . exp(S) 

supported network, mmdf: routes mail locally and over any . mmdf(ADM) 

/system services, library routines and error numbers. . . . Intro(S) 

points in a driver object/ routines: finds driver entry .... routines(ADM) 

ldfcn: common object file access routines .ldfcn(F) 

expression compile and match routines, regexp: Regular .... regexp(S) 
/converts a XENIX-style Micnet routing file to MMDF/.mnlist(ADM) 
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/hashed database of alias and 
(command interpreter). 

multiuser environment rc2: 
the operating system rcO: 

runacct: 

/prctmp, prdaily, prtacct, 
priority, nice: 
and quits, nohup: 
- handle special functions of 
handle special functions of the 
object downloader for the 5620 
id: print user and group 
/Micnet routing file to 
XENIX-style aliases file to 
alias and/ dbmbuild: builds the 
cleanup program strclean: 

daemon strerr: 
strace: Prints 
backup: performs 
volcopy: make literal copy of 
optimal access time dcopy: copy 
filesystem backup/ restore: AT&T 
link_unix: builds a new 
/prfdc, prfsnap, prfpr - 
/prfstat, prfdc, prfsnap, prfpr 
fs: file system - format of 
uulist: converts a XENIX-style 
system/ xrestore: Invokes 
filesystem/ xbackup: Performs 
activity report/ sar: sar, 
report package sar: sar, sal, 
editing activity, 
package sar: sar, sal, sa2, 

purge: the policy file of the 
activity report package sar: 
system activity report package 
space allocation, 
work, uucico: 
and formats input. 

bfs: 

creates bad track/ badtrk: 
help: Asks for help about 
the delta commentary of an 
comb: Combines 
sact: Prints current 
prs: Prints an 
rmdel: Removes a delta from an 
sccsfile: Format of an 


routing information. 

rsh: Invokes a restricted shell . . . 
rtc: real time clock interface . . . 
run commands performed for ... 
run commands performed to stop 

run daily accounting . 

runacct: run daily accounting . . . 
runacct, shutacct, startup,/ .... 
Runs a command at a different . . 
Runs a command immune to hangups 
DASI300 and 300s/ /300s . . . . 

DASI450 terminal 450:. 

DMD terminal wtinit:. 

IDs and names . 

MMDF format. 

MMDF format, /converts . . . . 
MMDF hashed database of .... 

STREAMS error logger . 

STREAMS error logger . 

STREAMS trace messages .... 

UNIX backup functions. 

UNIX file system. 

UNIX filesystems for. 

UNIX incremental . 

UNIX system kernel. 

UNIX system profiler. 

UNIX system profiler. 

UNIX system volume. 

UUCP routing file to/. 

XENIX incremental file . 

XENIX incremental. 

sal, sa2, sadc - system . 

sa2, sadc - system activity .... 
sact: Prints current SCCS file ... 
sadc - system activity report . . . 
sag: system activity graph .... 
sanitization utility purge(C) . . . 
sar, sal, sa2, sadc - system .... 

sar: sar, sal, sa2, sadc -. 

sbrk, brk: Changes data segment 
Scan the spool directory for . ... 
scanf, fscanf, sscanf: Converts . . 

Scans big files.. . . 

Scans fixed disk for flaws and . . 

SCCS commands. 

SCCS delta, cdc: Changes .... 

SCCS deltas. 

SCCS file editing activity. 

SCCS file. 

SCCS file. 

SCCS file. 


dbmbuild(ADM) 

rsh(C) 

rtc(HW) 

rc2(ADM) 

rcO(ADM) 

runacct(ADM) 

runacct(ADM) 

acctsh(ADM) 

nice(C) 

nohup(C) 

300(C) 

450(C) 

wtinit(ADM) 

id(ADM) 

mnlist(ADM) 

mmdfalias(ADM) 

dbmbuild(ADM) 

strclean(ADM) 

strerr(ADM) 

strace(ADM) 

backup(ADM) 

volcopy(ADM) 

dcopy(ADM) 

restore(ADM) 

link_unix(ADM) 

profiler(ADM) 

profiler(ADM) 

fs(F) 

uulist(ADM) 

xrestore(ADM) 

xbackup(ADM) 

sar(ADM) 

sar(ADM) 

sact(CP) 

sar(ADM) 

sag(ADM) 

purge(F) 

sar(ADM) 

sar(ADM) 

sbrk(S) 

uucico(C) 

scanf(S) 

bfs(C) 

badtrk(ADM) 

help(CP) 

cdc(CP) 

comb(CP) 

sact(CP) 

prs(CP) 

rmdel(CP) 

sccsfile(F) 
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val: Validates an SCCS file.val(CP) 

Makes a delta (change) to an SCCS file, delta: .delta(CP) 

admin: Creates and administers SCCS files.admin(CP) 

Compares two versions of an SCCS file, sccsdiffi .sccsdifl^CP) 

Undoes a previous get of an SCCS file, unget: .unget(CP) 

of an SCCS file, sccsdiffi Compares two versions . sccsdifi^CP) 

file, sccsfile: Format of an SCCS . . . sccsfile(F) 

system backups schedule: Database for automated . schedule(ADM) 
transport program uusched: the scheduler for the uucp file .... uusched(ADM) 
common object file scnhdr: section header for a ... scnhdr(F) 
screen image file. scr_dump: format of curses . . . scr_dump(F) 
curses: Performs screen and cursor functions. . . . curses(S) 

clear: Clears a terminal screen.clear(C) 

setcolor: Set screen color.setcolor(C) 

scr_dump: format of curses screen image file.scr_dump(F) 

convkey: Configure monitor screen mapping, /mapstr, .... mapkey(M) 

color, monochrome, ega,. screen: tty [01 -n], .screen(HW) 

vi, view, vedit: Invokes a screen-oriented display editor. . . vi(C) 

install: Installation shell script.install(M) 

IMAGEN printer interface scripts, /imagen.remote: .... imagen(M) 

XENIX installation shell script xinstall: .xinstall(ADM) 

interface, scsi: Small computer systems . . . scsi(HW) 

sdb: Invokes symbolic debugger. . sdb(CP) 
dates, sddate: Prints and sets backup . . sddate(C) 

access to a shared data/ sdenter, sdleave: Synchronizes . . sdenter(S) 

sdevice: file format.sdevice(F) 

shared data segment, sdget, sdfree: Attaches and detaches a . . sdget(S) 

detaches a shared data segment, sdget, sdfree: Attaches and . . . sdget(S) 

shared data access, sdgetv, sdwaitv: Synchronizes . . sdgetv(S) 

side-by-side, sdiff: Compares files .sdiff(C) 

a shared data segment, sdenter, sdleave: Synchronizes access to . sdenter(S) 
data access, sdgetv, sdwaitv: Synchronizes shared . . sdgetv(S) 

lsearch, lfind: Performs linear search and update.lsearch(S) 

bsearch: Performs a binary search.bsearch(S) 

hcreate, hdestroy: Manages hash search tables, hsearch, .hsearch(S) 

tdelete, twalk: Manages binary search trees, tsearch, tfind, . . . tsearch(S) 

grep, egrep, fgrep: Searches a file for a pattern. . . . grep(C) 

accounting files, acctcom: Searches for and prints process . . acctcom(ADM) 

pattern in a file, awk: Searches for and processes a ... awk(C) 

object file scnhdr: section header for a common . . . scnhdr(F) 

getty initcond: special security actions for init and . . . initcond(ADM) 

description subsystem: security subsystem component . . subsystem(M) 

sed: Invokes the stream editor. . . sed(C) 

uniformly distributed. srand48, seed48, lcong48: Generates . . . drand48(S) 

brkctl: Allocates data in a far segment.brkctl(S) 

shmget: Gets a shared memory segment.shmget(S) 

sbrk, brk: Changes data segment space allocation.sbrk(S) 

fp_seg: Return offset and segment. fp_off,.fp_seg(DOS) 

and detaches a shared data segment, /sdfree: Attaches . . . sdget(S) 

access to a shared data segment, /sdleave: Synchronizes . sdenter(S) 

segread: command description. . . segread(DOS) 
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multiplexing, select: synchronous I/O.select(S) 

greek: select terminal filter .greek(C) 

a file, cut: Cuts out selected fields of each line of . . . cut(C) 

idcheck: returns selected information .idcheck(ADM) 

binary files, hdr: Displays selected parts of executable . . . hdr(CP) 

to two sorted files, comm: Selects or rejects lines common . . comm(C) 

opensem: Opens a semaphore.opensem(S) 

semctl: Controls semaphore operations.semctl(S) 

semop: Performs semaphore operations.semop(S) 

ipcrm: Removes a message queue, semaphore set or shared memory. . ipcrm(ADM) 

to a resource governed by a semaphore, /and checks access . . waitsem(S) 

Creates an instance of a binary semaphore, creatsem: .creatsem(S) 

files, lockf: Provide semaphores and record locking on . lockf(S) 

semget: Gets set of semaphores.semget(S) 

Signals a process waiting on a semaphore, sigsem: .sigsem(S) 

operations, semctl: Controls semaphore . . . semctl(S) 

semget: Gets set of semaphores. . semget(S) 

fsphoto: Performs periodic semi-automated system backups . fsphoto(ADM) 

operations, semop: Performs semaphore . . . semop(S) 

hello: Send a message to another user. . . hello(ADM) 

lineprinter. Ip, cancel: Send/cancel requests to.lp(C) 

group of processes, kill: Sends a signal to a process or a . . kill(S) 

mail, mail: Sends, reads or disposes of ... . mail(C) 

/sys_errlist, sys_nerr, ermo: Sends system error messages. . . perror(S) 

mesg: Permits or denies messages sent to a terminal.mesg(C) 

file to printer attached to a serial console /Print .consoleprint(ADM) 

mscreen: Serial multiscreens utility .... mscreen(M) 

,tty2[A-H]: Interface to serial ports. /, tty2[a-h] .serial(HW) 

calendar: Invokes a reminder service.calendar(C) 

error/ intro: Introduces system services, library routines and . . . Intro(S) 

disable auditing for the next session chg_audit: enables and . . chg_audit(ADM) 

Map of the ASCII character set. ascii: .ascii(M) 

buffering to a stream, setbuf, setvbuf: Assigns.setbuf(S) 

real-time (time of day) clock, setclock: Sets the system .... setclock(ADM) 

setcolor: Set screen color.setcolor(C) 

setuid, setgid: Sets user and group IDs. . . setuid(S) 

getgrent, getgrgid, getgmam, setgrent, endgrent: Get group/ . . getgrent(S) 

nonlocal “goto”, setjmp, longjmp: Performs a . . . setjmp(S) 

keys, setkey: Assigns the function . . . setkey(C) 

international environment setlocale: Set or read.setlocale(S) 

table, setmnt: Establishes /etc/mnttab . . setmnt(ADM) 

setmode: Sets translation mode. . . setmode(DOS) 
setpgrp: Sets process group ID. . . setpgrp(S) 
getpwent, getpwuid, getpwnam, setpwent, endpwent: Gets/ .... getpwent(S) 

alarm: Sets a process’ alarm clock. . . . alarm(S) 

to one charater. strset: Sets all characters in a string . . . strset(DOS) 

mask, umask: Sets and gets file creation .... umask(S) 

sddate: Prints and sets backup dates.sddate(C) 

execution, env: Sets environment for command . . env(C) 

ev_setemask: Sets event mask.ev_stemsk(S) 

modification times, utime: Sets file access and.utime(S) 


1-57 
























Permuted Index 


umask: Sets file-creation mode mask. . . umask(C) 

setpgrp: Sets process group ID.setpgrp(S) 

tset: Sets terminal modes.. tset(C) 

speed, and line/ getty: Sets terminal type, modes, .... getty(M) 
base, cmos: Displays and sets the configuration data .... cmos(HW) 

date: Prints and sets the date.date(C) 

a video device, vidi: Sets the font and video mode for . vidi(C) 
stty: Sets the options for a terminal. . . stty(C) 

of day) clock, setclock: Sets the system real-time (time . . setclock(ADM) 

stime: Sets the time.stime(S) 

setmode: Sets translation mode.setmode(DOS) 

trchan: Translate character sets.trchan(M) 

time, profile: Sets up an environment at login . . profile(M) 

setuid, setgid: Sets user and group IDs.setuid(S) 

ulimit: Gets and sets user limits.ulimit(S) 

modification dates of files, settime: Changes the access and . settime(ADM) 

gettydefs: Speed and terminal settings used by getty.gettydefs(F) 

group IDs. setuid, setgid: Sets user and . . . setuid(S) 
stream, setbuf, setvbuf: Assigns buffering to a . . setbuf(S) 

(F) sfsys: file format.sfsys 

sfsys: file format.sfsys(F) 

data in a/ sputl, sgetl: Accesses long integer . . . sputl(S) 

interpreter, sh: Invokes the shell command . . sh(C) 

sdgetv, sdwaitv: Synchronizes shared data access.sdgetv(S) 

sdfree: Attaches and detaches a shared data segment, sdget, . . . sdget(S) 

Synchronizes access to a shared data segment, /sdleave: . . sdenter(S) 

shmctl: Controls shared memory operations. . . . shmctl(S) 

shmop: Performs shared memory operations. . . . shmop(S) 

shmget: Gets a shared memory segment.shmget(S) 

message queue, semaphore set or shared memory, ipcrm: Removes a ipcrm(ADM) 

sopen: Opens a file for shared reading and writing. . . . sopen(DOS) 

rsh: Invokes a restricted shell (command interpreter). . . . rsh(C) 

sh: Invokes the shell command interpreter.sh(C) 

C-like syntax, csh: Invokes a shell command interpreter with . . csh(C) 

system: Executes a shell command.system(S) 

shl: Shell layer manager.shl(C) 

Change login, group, or dialup shell password, passwd: .... passwd(C) 

/shutacct, startup, tumacct - shell procedures for accounting . . acctsh(ADM) 

/shutacct, startup, tumacct shell procedures for/ .acctsh(ADM) 

install: Installation shell script.install(M) 

xinstall: XENIX installation shell script.. • xinstall(ADM) 

shl: Shell layer manager.shl(C) 

operations, shmctl: Controls shared memory . shmctl(S) 

segment, shmget: Gets a shared memory . . shmget(S) 

operations, shmop: Performs shared memory . shmop(S) 

nap: Suspends execution for a short interval.nap(S) 

/prdaily, prtacct, runacct, shutacct, startup, tumacct -/ ... acctsh(ADM) 

halts the CPU. shutdn: Flushes block I/O and . . shutdn(S) 

processing, shutdown: Terminates all .... shutdown(ADM) 
Closes out the file systems and shuts down the system, /reboot: . haltsys(ADM) 

sdiff: Compares files side-by-side.sdiff(C) 
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Suspends a process until a signal occurs, pause:.pause(S) 

upon receipt of a signal, signal: Specifies what to do ... signal(S) 
of processes, kill: Sends a signal to a process or a group . . . kill(S) 
semaphore, sigsem: Signals a process waiting on a . . sigsem(S) 

what to do upon receipt of a signal, signal: Specifies.signal(S) 

gsignal: Implements software signals, ssignal,.ssignal(S) 

waiting on a semaphore, sigsem: Signals a process .... sigsem(S) 
atan2: Performs trigonometric/ sin, cos, tan, asin, acos, atan, . . . trig(S) 

sulogin: access single-user mode .sulogin(ADM) 

hyperbolic functions, sinh, cosh, tanh: Performs .... sinh(S) 

cmchk: Reports hard disk block size.cmchk(C) 

chsize: Changes the size of a file.chsize(S) 

size: Prints the size of an object file.size(CP) 

jwin: print size of layer .jwin(C) 

object file, size: Prints the size of an .... size(CP) 

interval, sleep: Suspends execution for an . sleep(C) 

interval, sleep: Suspends execution for an . sleep(S) 

current/ ttyslot: Finds the slot in the utmp file of the .... ttyslot(S) 

spline: Interpolates smooth curve.spline(CP) 

swconfig: produces a list of the software modifications to the/ . . swconfig(C) 

ssignal, gsignal: Implements software signals.ssignal(S) 

reading and writing, sopen: Opens a file for shared . . sopen(DOS) 

qsort: Performs a quicker sort.qsort(S) 

sort: Sorts and merges files. . . . sort(C) 

or rejects lines common to two sorted files, comm: Selects . . . comm(C) 

tsort: Sorts a file topologically.tsort(CP) 

sort: Sorts and merges files.sort(C) 

an error message file from C source, mkstr: Creates .mkstr(CP) 

sbrk, brk: Changes data segment space allocation.sbrk(S) 

idspace: investigates free space .idspace(ADM) 

ct: spawn getty to a remote terminal . ct(C) 
process, spawnl, spawnvp: Creates a new . spawn(DOS) 

spawnl, spawnvp: Creates a new process. . spawn(DOS) 

movedata: Copies bytes from a specific address.movedata(DOS) 

sysi86: machine specific functions.sysi86(S) 

fspec: format specification in text files.fspec(F) 

idmkinit: read files containing specifications.idmkinit(ADM) 

purge: overwrites specified files.purge(C) 

/the list of vectors currently specified inthesdevice/ . vectorsinuse(ADM) 
/major device numbers currently specified in the mdevice file . . . majorsinuse(ADM) 

cron: Executes commands at specified times.cron(C) 

temporary files in directories specified cleantmp: remove . . . cleantmp(ADM) 

receipt of a signal, signal: Specifies what to do upon .... signal(S) 

/Sets terminal type, modes, speed, and line discipline.getty(M) 

/set terminal type, modes, speed, and line discipline .... uugetty(ADM) 

by getty. gettydefs: Speed and terminal settings used . gettydefs(F) 

hashcheck: Finds spelling/ spell, hashmake, spellin, .... spell(C) 

spelling/ spell, hashmake, spellin, hashcheck: Finds .... spell(C) 

spellin, hashcheck: Finds spelling errors, /hashmake, . . . spell(C) 

curve, spline: Interpolates smooth . . . spline(CP) 

pieces, split: Splits a file into.split(C) 
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split: Splits a file into pieces.split(C) 

context, csplit: Splits files according to.csplit(C) 

into a/ frexp, ldexp, modf: Splits floating-point number . . . frexp(S) 

uuclean: uucp spool directory clean-up.uuclean(ADM) 

uucico: Scan the spool directory for work.uucico(C) 

Configures the lineprinter spooling system, lpadmin: .... lpadmin(ADM) 

printf, fprintf, sprintf: Formats output.printf(S) 

integer data in a/ sputl, sgetl: Accesses long .... sputl(S) 

exponential,/exp, log, pow, sqrt, log 10: Performs.exp(S) 

exponential, logarithm, power, square root functions. /Performs . exp(S) 
number, rand, srand: Generates a random .... rand(S) 

Generates uniformly/ srand48, seed48, lcong48: .... drand48(S) 
input, scanf, fscanf, sscanf: Converts and formats . . . scanf(S) 

software signals, ssignal, gsignal: Implements . . . ssignal(S) 

output, stdio: Performs standard buffered input and . . . stdio(S) 

Converts Rational FORTRAN into standard FORTRAN, ratfor: . . . ratfor(CP) 

gets: Gets a string from the standard input.gets(CP) 

communication package, ftok: Standard interprocess.stdipc(S) 

pr: Prints files on the standard output.pr(C) 

lpsched, lpshut, lpmove: Starts/stops the lineprinter/ .... lpsched(ADM) 
/prtacct, runacct, shutacct, startup, tumacct - shell/ ..... acctsh(ADM) 
system call, stat: Data returned by stat .... stat(F) 

stat, fstat: Gets file status.stat(S) 

stat: Data returned by stat system call.stat(F) 

information, statfs: get file system.statfs(S) 

ustat: Gets file system statistics.. ustat(S) 

virtual memory statistics, vmstat: Reports .... vmstat(C) 

xts: extract and print xt driver statistics.xts(ADM) 

fsstat: report file system status .fsstat(ADM) 

lpstat: prints lineprinter status information.lpstat(C) 

uustat: uucp status inquiry and job control. . . uustat(C) 

communication/ ipcs: Reports the status of inter-process.ipcs(ADM) 

ps: Reports process status.ps(C) 

checkque: MMDF queue status report generator .checkque(ADM) 

stat, fstat: Gets file status.stat(S) 

fileno: Determines stream status, ferror, feof, clearerr, . . . ferror(S) 

buffered input and output, stdio: Performs standard.stdio(S) 

stime: Sets the time.stime(S) 

Waits for a child process to stop or terminate, wait:.wait(S) 

rcO: run commands performed to stop the operating system .... rcO(ADM) 

compress: Compress data for storage.compress(C) 

nextkey:/ dbminit, fetch, store, delete, firstkey,.dbm(S) 

uncompress: Uncompress a stored file.compress(C) 

zcat: Display a stored file.compress(C) 

queue: MMDF queue files for storing mail in transit.queue(ADM) 

trace messages strace: Prints STREAMS.strace(ADM) 

logger cleanup program strclean: STREAMS error .... strclean(ADM) 

operations, strdup: Performs string .string(S) 

Invokes the stream editor, sed: .sed(C) 

fopen, freopen, fdopen: Opens a stream.fopen(S) 

puts, fputs: Puts a string on a stream.puts(S) 
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clearerr, fileno: Determines stream status, ferror, feof, .... ferror(S) 

fflush: Closes or flushes a stream, fclose, .fclose(S) 

Gets a character from a stream, fgetc, fgetchar:.fgetc(DOS) 

fputchar: Write a character to a stream, fputc,.fputc(DOS) 

Repositions a file pointer in a stream, fseek, ftell, rewind: . . . fseek(S) 

Gets character or word from a stream, /getchar, fgetc, getw: . . getc(S) 

fgets: Gets a string from a stream, gets, .gets(S) 

Prints the first few lines of a stream, head:.head(C) 

Puts a character or word on a stream, /putchar, fputc, putw: . . putc(S) 

fclose, fcloseall: Closes streams.fclose(DOS) 

setvbuf: Assigns buffering to a stream, setbuf, .setbuf(S) 

Pushes character back into input stream, ungetc: .ungetc(S) 

logger daemon strerr: STREAMS error .strerr(ADM) 

string strftime: format date/time .... strftime(S) 

cgets: Gets a string.cgets(DOS) 

files gps: graphical primitive string, format of graphical .... gps(F) 

gets, fgets: Gets a string from a stream.gets(S) 

getclk: gets string from real-time clock .... getclk(M) 
gets: Gets a string from the standard input. . . gets(CP) 

puts, fputs: Puts a string on a stream.puts(S) 

strdup: Performs string operations.string(S) 

yes: Prints string repeatedly.yes(C) 

strftime: format date/time string .strftime(S) 

strlen: Returns the length of a string.strlen(DOS) 

strtod, atof: Converts a string to a double-precision/ . . . strtod(S) 

strtol, atol, atoi: Converts string to integer.strtol(S) 

strset: Sets all characters in a string to one charater.strset(DOS) 

cputs: Puts a string to the console.cputs(DOS) 

strings in an object file, strings: Finds the printable .... strings(CP) 

xstr: Extracts strings from C programs.xstr(CP) 

strings: Finds the printable strings in an object file.strings(CP) 

the order of characters in a string, strrev: Reverses.strrev(DOS) 

relocation bits, strip: Removes symbols and . . . strip(CP) 

string, strlen: Returns the length of a . . strlen(DOS) 
characters to lowercase, strlwr: Converts uppercase .... strlwr(DOS) 
characters in a string, strrev: Reverses the order of ... strrev(DOS) 
string to one charater. strset: Sets all characters in a ... strset(DOS) 
to a double-precision number, strtod, atof: Converts a string . . . strtod(S) 
string to integer, strtol, atol, atoi: Converts .... strtol(S) 

mount: Mounts a file structure.mount(ADM) 

umount: Dismounts a file structure.umount(ADM) 

characters to uppercase, strupr: Converts lowercase .... strupr(DOS) 
terminal, stty: Sets the options for a .... stty(C) 

(F) stune: file format.stune 

stune: file format.stune(F) 

or another user, su: Makes the user a super-user . . su(C) 

submit: MMDF mail enqueuer . . submit(ADM) 
UUCP rmail: submit remote mail received via . rmail(ADM) 
/checks for mail which has been submitted but not delivered . . . checkmail(C) 
command interface for audit subsystem activationy auditcmd: . auditcmd(ADM) 
files generated by the audit subsystem and /audit collection . auditd(ADM) 
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subsystem: security subsystem component description . subsystem(M) 
produce audit records for subsystem events dlvr_audit: . . dlvr_audit(ADM) 

audit: audit subsystem interface device . . . audit(ADM) 

component description subsystem: security subsystem . . subsystem(M) 

interface for authorization subsystem /administrator .... authtsh(ADM) 
sulogin: access single-user mode . sulogin(ADM) 
counts blocks in a file, sum: Calculates checksum and . . sum(C) 

du: Summarizes disk usage.du(C) 

ownership, quot: Summarizes file system.quot(C) 

accounting/ acctcms: command summary from per-process .... acctcms(ADM) 

sync: Updates the super-block.sync(ADM) 

sync: Updates the super-block.sync(S) 

su: Makes the user a super-user or another user.su(C) 

routes mail locally and over any supported network, mmdf: . . . mmdf(ADM) 

terminals: List of supported terminals.terminals(M) 

keyboard mode or test keyboard support kbmode: Set.kbmode(ADM) 

ev_resume: Restart a suspended queue.ev_resume(S) 

signal occurs, pause: Suspends a process until a . . . . pause(S) 

ev_suspend: Suspends an event queue.ev_susp(S) 

interval, nap: Suspends execution for a short . . nap(S) 
interval, sleep: Suspends execution for an .... sleep(C) 
interval, sleep: Suspends execution for an .... sleep(S) 

swab: Swaps bytes.swab(S) 

swap: swap administrative interface . . swap(ADM) 

swapadd: Adds swap area .swapadd(S) 

interface swap: swap administrative .... swap(ADM) 
swapadd: Adds swap area .... swapadd(S) 

swab: Swaps bytes.swab(S) 

fdswap: Swaps default boot floppy drive. . fdswap(ADM) 
software modifications to the/ swconfig: produces a list of the . . swconfig(C) 

sxt: Pseudo-device driver.sxt(M) 

syms: common object file symbol table format .syms(F) 

unistd: file header for symbolic constants.unistd(F) 

sdb: Invokes symbolic debugger.sdb(CP) 

strip: Removes symbols and relocation bits. . . . strip(CP) 

table format syms: common object file symbol . syms(F) 

sync: Updates the super-block. . . sync(ADM) 

sync: Updates the super-block. . . sync(S) 

data segment, sdenter, sdleave: Synchronizes access to a shared . sdenter(S) 

sdgetv, sdwaitv: Synchronizes shared data access. . sdgetv(S) 

select: synchronous I/O multiplexing. . . select(S) 

command interpreter with C-like syntax, csh: Invokes a shell . . . csh(C) 

Checks C language usage and syntax, lint: .lint(CP) 

administration utility, sysadmsh: Menu driven system . . sysadmsh(ADM) 

parameters sysdef: output values of tunable . . sysdef(ADM) 

Sends system error/ perror, sys_errlist, sys_nerr, ermo: . . . perror(S) 

sysfiles: Format of UUCP Sysfiles file.sysfiles(F) 

Sysfiles file, sysfiles: Format of UUCP .... sysfiles(F) 

functions. sysi86: machine specific .... sysi86(S) 
error/ perror, sys_errlist, sys_nerr, ermo: Sends system . . perror(S) 

sar: sar, sal, sa2, sadc system activity report/ .sar(ADM) 
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config: Configures a XENIX system.config(ADM) 

cu: Calls another XENIX system.cu(C) 

procedures brc: brc, bcheckrc system initialization .brc(ADM) 

mkfs: Constructs a file system.mkfs(ADM) 

mount: Mounts a file system.mount(S) 

umount: Unmounts a file system.umount(S) 

who: Lists who is on the system.who(C) 

Automatically boots the system, autoboot: .autoboot(ADM) 

identification file, systemid: The Micnet system . . . systemid(F) 
the lineprinter spooling system, lpadmin: Configures . . . lpadmin(ADM) 
file systems and shuts down the system, /reboot: Closes out the . . haltsys(ADM) 
commands on a remote XENIX system, remote: Executes .... remote(C) 
/reboot: Closes out the file systems and shuts down the/ . . . haltsys(ADM) 

systems: Format of UUCP Systems file.systems(F) 

file, systems: Format of UUCP Systems systems(F) 

fsck: Checks and repairs file systems.fsck(ADM) 

scsi: Small computer systems interface.scsi(HW) 

labelit: provide labels for file systems .labelit(ADM) 

checklist: List of file systems processed by fsck .checklist(F) 

rep: Copies files across XENIX systems.rcp(C) 

- mount, unmount multiple file systems /mountall, umountall . . mountall(ADM) 

the name of the current XENIX system, uname: Prints .uname(C) 

Gets name of current XENIX system, uname:.uname(S) 

device, systty: System maintenance . . . systty(M) 

chrtbl: create a ctype locale table .chrtbl(M) 

curtbl: create a currency locale table .curtbl(M) 

syms: common object file symbol table format .syms(F) 

numtbl: Create a numeric locale table.numtbl(M) 

setmnt: Establishes /etc/mnttab table.setmnt(ADM) 

for flaws and creates bad track table, badtrk: Scans fixed disk . . badtrk(ADM) 

create a collation locale table coltbl: .coltbl(M) 

Format of mounted file system table, mnttab:.mnttab(F) 

term: Terminal driving tables for nroff. .term(F) 

tables: MMDF Name Tables . . . tables(F) 

tables: MMDF Name Tables.tables(F) 

hdestroy: Manages hash search tables, hsearch, hcreate, .... hsearch(S) 

NIC database into channel/domain tables nictable: process ..... nictable(ADM) 

tabs: set tabs on a terminal .tabs(C) 

tabs: set tabs on a terminal .... tabs(C) 

ctags: Creates a tags file.ctags(CP) 

a file, tail: Delivers the last part of ... tail(C) 

Performs/ sin, cos, tan, asin, acos, atan, atan2: .... trig(S) 
functions, sinh, cosh, tanh: Performs hyperbolic .... sinh(S) 
tape device tapecntl: AT&T tape control for QIC-24/QIC-02 . . tapecntl(C) 
tape control for QIC-24/QIC-02 tape device tapecntl: AT&T . . . tapecntl(C) 

backup: Incremental dump tape format.backup(F) 

program, tape: Magnetic tape maintenance . tape(C) 
tape: Magnetic tape maintenance program. . . . tape(C) 

tapedump: Dumps magnetic tape to output file.tapedump(C) 

QIC-24/QIC-02 tape device tapecntl: AT&T tape control for . . tapecntl(C) 
output file, tapedump: Dumps magnetic tape to tapedump(C) 
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search trees, tsearch, tfind, 

tee: Creates a 
4014: paginator for the 
last logins of users and 
temporary file, tmpnam, 
print and/or restrict privileges 
tmpfile: Creates a 
specified cleantmp: remove 
tempnam: Creates a name for a 
for nroff. 

terminfo/ captoinfo: convert a 
data base, 
termcap: 
terminfo: 
ct: spawn getty to a remote 
terminfo: 
nroff. term: 
greek: select 
tgetstr, tgoto, tputs: Performs 
termio: General 
termios: POSIX general 
tty: Special 
jterm: reset layer of windowing 
dial: Establishes an out-going 
lock: Locks a user’s 

tset: Sets 
clear: Clears a 
gettydefs: Speed and 
ismpx: return windowing 
stty: Sets the options for a 
tabs: set tabs on a 
terminal: Login 
line discipline, getty: Sets 
line discipline uugetty: set 
used between host and windowing 
paginator for the TEKTRONIX 4014 
Generates a filename for a 
host control of windowing 
a printer attached to the user’s 
or denies messages sent to a 
for the 5620 DMD 
enable: Ttais on 
disable: Turns off 
inittab: Alternative login 
terminals, 
tty: Gets the 
terminals: List of supported 


tar: archive format. 

tar: Archives files. 

tdelete, twalk: Manages binary 
tee: Creates a tee in a pipe. . . 

tee in a pipe. 

TEKTRONIX 4014 terminal . . 
teletypes last: Indicate . . . , 
tempnam: Creates a name for a 

temporarily privs:.. 

temporary file.. 

temporary files in directories . , 
temporary file, tmpnam, . . 
term: Terminal driving tables . 
termcap description into a . . 
termcap: Terminal capability . 
Terminal capability data base, 
terminal capability data base. . 

terminal . 

terminal description database. 
Terminal driving tables for . . 

terminal filter. 

terminal functions, /tgetflag, . 

terminal interface. 

terminal interface. 

terminal interface. 

terminal . 

terminal line connection. . . 

terminal. 

terminal: Login terminal. . . 

terminal modes. 

terminal screen. 

terminal settings used by getty. 

terminal state. 

terminal. 

terminal . 

terminal. 

terminal type, modes, speed, and 
terminal type, modes, speed, and 
terminal under layers: protocol 

terminal 4014: . 

terminal, ctermid:. 

terminal jagent:. 

terminal lprint: Print to ... 
terminal, mesg: Permits . . . 
terminal /object downloader . 
terminals and line printers. . . 
terminals and printers. . . . 

terminals file. 

terminals: List of supported 

terminal’s name. 

terminals. 


tar(F) 

tar(C) 

tsearch(S) 

tee(C) 

tee(C) 

4014(C) 

last(C) 

tmpnam(S) 

privs(C) 

tmpfile(S) 

cleantmp(ADM) 

tmpnam(S) 

term(F) 

captoinfo(ADM) 

termcap(M) 

termcap(M) 

terminfo(M) 

ct(C) 

terminfo(S) 

term(F) 

greek(C) 

termcap(S) 

termio(M) 

termios(M) 

tty(M) 

jterm(C) 

dial(S) 

lock(C) 

terminal(HW) 

tset(C) 

clear(C) 

gettydefs(F) 

ismpx(C) 

stty(C) 

tabs(C) 

terminal(HW) 

getty(M) 

uugetty(ADM) 

layers(M) 

4014(C) 

ctermid(S) 

jagent(M) 

lprint(C) 

mesg(C) 

wtinit(ADM) 

enable(C) 

disable(C) 

inittab(F) 

terminals(M) 

tty(C) 

terminals(M) 
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functions of Hewlett-Packard terminals hp: handle special . . . hp(C) 

layer multiplexer for windowing terminals layers: .layers(C) 

tty driver for AT&T windowing terminals xt: multiplexed .... xt(HW) 

isatty: Finds the name of a terminal, ttyname,.ttyname(S) 

exit, _exit: Terminates a process.exit(S) 

kill: Terminates a process.kill(C) 

shutdown: Terminates all processing.shutdown(ADM) 

exit: Terminates the calling process. . . exit(DOS) 

for a child process to stop or terminate, wait: Waits .wait(S) 

for audit subsystem activation, termination, /command interface . auditcmd(ADM) 

tic: Terminfo compiler.tic(C) 

tput: Queries the terminfo database.tput(C) 

a termcap description into a terminfo description /convert . . captoinfo(ADM) 

infocmp: compare or print out terminfo descriptions.infocmp(ADM) 

terminfo: Format of compiled terminfo file.terminfo(F) 

terminfo file, terminfo: Format of compiled . . terminfo(F) 

database, terminfo: terminal capability . . . terminfo(M) 

database, terminfo: terminal description . . terminfo(S) 

interface, termio: General terminal .... termio(M) 

interface, termios: POSIX general terminal . termios(M) 

kbmode: Set keyboard mode or test keyboard support.kbmode(ADM) 

test: Tests conditions.test(C) 

test: Tests conditions.test(C) 

ed: Invokes the text editor.ed(C) 

ex: Invokes a text editor.ex(C) 

casual users) edit: text editor (variant of ex for . . . edit(C) 

newform: Changes the format of a text file.newform(C) 

diffl Compares two text files.diff(C) 

fspec: format specification in text files.fspec(F) 

imprint: Prints text files on an IMAGEN printer. . imprint(C) 

plock: Lock process, text, or data in memory.plock(S) 

binary search trees, tsearch, tfind, tdelete, twalk: Manages . . tsearch(S) 

tgetstr, tgoto, tputs: Performs/ tgetent, tgetnum, tgetflag, .... termcap(S) 
Performs/ tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: . . . termcap(S) 

tgoto, tputs: Performs/ tgetent, tgetnum, tgetflag, tgetstr, .... termcap(S) 
tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: Performs/ . . termcap(S) 

/tgetnum, tgetflag, tgetstr, tgoto, tputs: Performs terminal/ . . termcap(S) 

tic: Terminfo compiler.tic(C) 

time, ftime: Gets time and date. . . time(S) 

clock: The system real-time (time of day) clock.clock(F) 

Sets the system real-time (time of day) clock, setclock: . . setclock(ADM) 

stime: Sets the time.stime(S) 

Executes commands at a later time, at, batch: .at(C) 

Sets up an environment at login time, profile: .profile(M) 

Executes commands at specified times, cron: .cron(C) 

Gets process and child process times, times: .times(S) 

file access and modification times, utime: Sets.utime(S) 

process data and system/ timex: time a command; report . . timex(ADM) 
time zone timezone: set default system . . . timezone(F) 

file, tmpfile: Creates a temporary . . . tmpfile(S) 

for a temporary file, tmpnam, tempnam: Creates a name tmpnam(S) 
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/isascii, tolower, toupper, toascii: Classifies or converts/ . . ctype(S) 
conv, toupper, tolower, toascii: Translates characters. . . conv(S) 
characters, conv, toupper, tolower, toascii: Translates .... conv(S) 

/isgraph, iscntrl, isascii, tolower, toupper, toascii:/ .... ctype(S) 
topology files, top, top.next: The Micnet .... top(F) 
files, top, top.next: The Micnet topology . . top(F) 

tsort: Sorts a file topologically.tsort(CP) 

top, top.next: The Micnet topology files.top(F) 

acctmerg: merge or add total accounting files.acctmerg(ADM) 

modification times of a file, touch: Updates access and .... touch(C) 

/iscntrl, isascii, tolower, toupper, toascii: Classifies or/ . . ctype(S) 
Translates characters, conv, toupper, tolower, toascii: .... conv(S) 

tplot: graphics filters .tplot(ADM) 

database, tput: Queries the terminfo .... tput(C) 

/tgetflag, tgetstr, tgoto, tputs: Performs terminal/ .... termcap(S) 

tr: Translates characters.tr(C) 

strace: Prints STREAMS trace messages .strace(ADM) 

ptrace: Traces a process.ptrace(S) 

and print xt driver packet traces xtt: extract .xtt(ADM) 

disk for flaws and creates bad track table. /Scans fixed .... badtrk(ADM) 
queue files for storing mail in transit queue: MMDF ..... queue(ADM) 

trchan: Translate character sets.trchan(M) 

one format to another translate: Translates files from . . translate(C) 

conv, toupper, tolower, toascii: Translates characters.conv(S) 

tr: Translates characters.tr(C) 

to another translate: Translates files from one format . . translate(C) 

setmode: Sets translation mode.setmode(DOS) 

decode a binary file for transmission via mail uudecode: . uuencode(C) 

encode a binary file for transmission via mail uuencode: . uuencode(C) 

the scheduler for the uucp file transport program uusched: . . . uusched(ADM) 

trchan: Translate character sets . . trchan(M) 

ftw: Walks a file tree.ftw(S) 

twalk: Manages binary search trees, tsearch, tfind, tdelete, . . . tsearch(S) 

acos, atan, atan2: Performs trigonometric functions, /asin, . . trig(S) 

i386 - get processor type truth value machid: machid, . . . machid(C) 

with debugging on uutry: try to contact remote system . . . uutry(ADM) 

Manages binary search trees, tsearch, tfind, tdelete, twalk: . . . tsearch(S) 

tset: Sets terminal modes.tset(C) 

topologically, tsort: Sorts a file.tsort(CP) 

mapchan: Format of tty device mapping files.mapchan(F) 

mapchan: Configure tty device mapping.mapchan(M) 

terminals xt: multiplexed tty driver for AT&T windowing . . xt(HW) 

tty: Gets the terminal’s name. . . tty(C) 

tty: Special terminal interface. . . tty(M) 

monochrome, ega,. screen: tty [01-/i], color,.screen(HW) 

tty2[a-h], tty2[A-H]:/ tty 1 [a-h], tty 1 [A-H].serial(HW) 

tty2[A-H]: Interface/ tty 1 [a-h] ttyl[A-H], tty2[a-h],.serial(HW) 

tty2[A-H]:/ ttyl[a-h], ttyl[A-H], tty2[a-h].serial(HW) 

to/ tty 1 [a-h], tty 1 [A-H], tty2[a-h], tty2[A-H]: Interface . . serial(HW) 

Interface/ tty 1 [a-h] , tty 1[A-H] tty2[a-h], tty2[A-H]:.serial(HW) 

/, tty 1 [A-H], tty2[a-h], tty2[A-H]: Interface to serial/ . . serial(HW) 
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ports. /, tty l[A-H],tty2[a-h] tty2[A-H]: Interface to serial . . . serial(HW) 

of a terminal, ttyname, isatty: Finds the name . . ttyname(S) 

utmp file of the current user, ttyslot: Finds the slot in the . . . ttyslot(S) 

attempts to set value of a tunable parameter idtune: .... idtune(ADM) 

sysdef: output values of tunable parameters.. sysdef(ADM) 

/runacct, shutacct, startup, tumacct - shell procedures for/ . . acctsh(ADM) 

printers, disable: Thins off terminals and .disable(C) 

accton: Turns on accounting.accton(ADM) 

printers, enable: Turns on terminals and line . . . enable(C) 

trees, tsearch, tfind, tdelete, twalk: Manages binary search . . tsearch(S) 

dtype: Determines disk type.dtype(C) 

file: Determines file type.file(C) 

getty: Sets terminal type, modes, speed, and line/ . . . getty(M) 

uugetty: set terminal type, modes, speed, and line/ . . . uugetty(ADM) 

machid, i386 - get processor type truth value machid: .... machid(C) 
types, types: Primitive system data . . . types(F) 

types: Primitive system data types.types(F) 

variable. TZ: Time zone environment . . . tz(M) 

/localtime, gmtime, asctime, tzset: Converts date and time to/ . ctime(S) 

uadmin: administrative control . . uadmin(ADM) 

uadmin: administrative control. . . uadmin(S) 

limits, ulimit: Gets and sets user .... ulimit(S) 
characters, ultoa: Converts numbers to ... ultoa(DOS) 
creation mask, umask: Sets and gets file .... umask(S) 

mask, umask: Sets file-creation mode . . umask(C) 
structure, umount: Dismounts a file .... umount(ADM) 
umount: Unmounts a file system. . umount(S) 
multiple/ mountall: mountall, umountall - mount, unmount . . . mountall(ADM) 

XENIX system, uname: Gets name of current . . . uname(S) 

current XENIX system, uname: Prints the name of the . . uname(C) 

uncompress: Uncompress a stored file.compress(C) 

file, uncompress: Uncompress a stored . compress(C) 
file, unget: Undoes a previous get of an SCCS unget(CP) 

an SCCS file, unget: Undoes a previous get of . . unget(CP) 

into input stream, ungetc: Pushes character back . . ungetc(S) 

the console buffer, ungetch: Returns a character to . . ungetch(DOS) 

seed48, lcong48: Generates uniformly distributed. srand48, . . drand48(S) 

a file, uniq: Reports repeated lines in . . uniq(C) 

mktemp: Makes a unique filename.mktemp(S) 

constants unistd: file header for symbolic . . unistd(F) 

units: Converts units.units(C) 

units: Converts units.units(C) 

link: link, unlink: link and unlink files and directories .... link(ADM) 
and directories link: link, unlink: link and unlink files . . . link(ADM) 

unlink: Removes directory entry. . unlink(S) 

reading or/ locking: Locks or unlocks a file region for.locking(S) 

/mountall, umountall - mount, unmount multiple file systems . . mountall(ADM) 

umount: Unmounts a file system.umount(S) 

files, pack, peat, unpack: Compresses and expands . pack(C) 

idinstall: add, delete, update, or get device driver/ . . . idinstall(ADM) 

Performs linear search and update, lsearch, lfind: .lsearch(S) 
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times of a file, touch: Updates access and modification . touch(C) 

of programs, make: Maintains, updates, and regenerates groups . make(CP) 

sync: Updates the super-block.sync(ADM) 

sync: Updates the super-block.sync(S) 

lowercase, strlwr: Converts uppercase characters to.strlwr(DOS) 

Converts lowercase characters to uppercase, strupr: .strupr(DOS) 

about system activity, uptime: Displays information . . . uptime(C) 

lint: Checks C language usage and syntax.lint(CP) 

du: Summarizes disk usage.du(C) 

clock: Reports CPU time used.clock(S) 

keystrokes usemouse: Maps mouse input to . usemouse(C) 

user, su: Makes the user a super-user or another . . . su(C) 

id: Prints user and group IDs and names. . . id(C) 

setuid, setgid: Sets user and group IDs.setuid(S) 

names id: print user and group IDs and .id(ADM) 

crontab: user crontab file.crontab(C) 

/getgid, getegid: Gets real user, effective user, real/.getuid(S) 

environ: The user environment.environ(M) 

hello: Send a message to another user.hello(ADM) 

getpw: Gets password for a given user ID.getpw(S) 

generate disk accounting data by user ID diskusg:.diskusg(ADM) 

newgrp: Logs user into a new group.newgrp(C) 

ulimit: Gets and sets user limits.ulimit(S) 

logname: Finds login name of user.logname(S) 

group/ /Gets real user, effective user, real group, and effective . . getuid(S) 

write: Writes to another user.write(C) 

Gets the login name of the user, cuserid:.cuserid(S) 

last: Indicate last logins of users and teletypes.last(C) 

finger: Finds information about users.finger(C) 

idleout: Logs out idle users.idleout(ADM) 

lock: Locks a user’s terminal.lock(C) 

to a printer attached to the user’s terminal lprint: Print . . . lprint(C) 

wall: Writes to all users.wall(ADM) 

editor (variant of ex for casual users) edit: text.edit(C) 

the user a super-user or another user, su: Makes.su(C) 

in the utmp file of the current user, ttyslot: Finds the slot . . . ttyslot(S) 

statistics, ustat: Gets file system .ustat(S) 

mscreen: Serial multiscreens utility .mscreen(M) 

policy file of the sanitization utility purge(C) purge: the .... purge(F) 

at and cron administration utility atcronsh: Menu driven . . atcronsh(ADM) 

Menu driven audit administration utility auditsh: .auditsh(ADM) 

driven backup administration utility backupsh: Menu.backupsh(ADM) 

lp print service administration utility lpsh: Menu driven .... lpsh(ADM) 
driven system administration utility, sysadmsh: Menu .... sysadmsh(ADM) 
modification times, utime: Sets file access and .... utime(S) 

utmp, wtmp: Formats of utmp and wtmp entries.utmp(F) 

endutent, utmpname: Accesses utmp file entry.getut(S) 

ttyslot: Finds the slot in the utmp file of the current user. . . . ttyslot(S) 

wtmp entries, utmp, wtmp: Formats of utmp and . utmp(F) 

entry, endutent, utmpname: Accesses utmp file . . getut(S) 

uuchat: dials a modem.dial(ADM) 
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directories and permissions/ uucheck: check the uucp . . . , 
for work, uucico: Scan the spool directory 
clean-up uuclean: uucp spool directory . . 

Administers UUCP control files, uuinstall: . . 

devices: Format of UUCP devices file. 

file, dialcodes: Format of UUCP dial-code abbreviations . . 

dialers: Format of UUCP Dialers file. 

file uucheck: check the uucp directories and permissions 
uusched: the scheduler for the uucp file transport program . . . 

maxuuscheds: UUCP uusched limit file. 

maxuuxqts: UUCP uuxqt limit file. 

uusub: Monitor uucp network. 

permissions: Format of UUCP Permissions file. 

poll: Format of UUCP Poll file. 

uuclean: uucp spool directory clean-up . . 
control, uustat: uucp status inquiry and job . . . 

sysfiles: Format of UUCP Sysfiles file. 

systems: Format of UUCP Systems file. 

submit remote mail received via UUCP rmail:. 

for transmission via mail uudecode: decode a binary file . . 

for transmission via mail uuencode: encode a binary file . . 

modes, speed, and line/ uugetty: set terminal type, .... 

files, uuinstall: Administers UUCP control 
UUCP routing file to/ uulist: converts a XENIX-style . . 

UUCP routing/ uulist: converts a XENIX-style. 

file copy, uuto, uupick: Public XENIX-to-XENIX . 
uucp file transport program uusched: the scheduler for the . . 

job control, uustat: uucp status inquiry and . . 

uusub: Monitor uucp network. . . 

XENIX-to-XENIX file copy, uuto, uupick: Public . 

system with debugging on uutry: try to contact remote . . . 

XENIX, uux: Executes command on remote 
val: Validates an SCCS file. . . . 

val: Validates an SCCS file. 

assert: Helps verify validity of program. 

abs: Returns an integer absolute value. 

ceil, fmod: Performs absolute value, floor, ceiling and/ /fabs, . . 

getenv: Gets value for environment name. . . . 

labs: Returns the absolute value of a long integer. 

idtune: attempts to set value of a tunable parameter . . . 

putenv: Changes or adds value to environment. 

true: Returns with a zero exit value. 

Returns with a nonzero exit value, false: . 

i386 - get processor type truth value machid: machid,. 

values: machine-dependent values 
sysdef: output values of tunable parameters . . . 

values: machine-dependent values. 

varargs: variable argument list. . . 

varargs: variable argument list. 

TZ: Time zone environment variable. 

edit: text editor (variant of ex for casual users) . . 


uucheck(ADM) 

uucico(C) 

uuclean(ADM) 

uuinstall(ADM) 

devices(F) 

dialcodes(F) 

dialers(F) 

uucheck(ADM) 

uusched(ADM) 

maxuuscheds(F) 

maxuuxqts(F) 

uusub(C) 

permissions(F) 

poll(F) 

uuclean(ADM) 

uustat(C) 

sysfiles(F) 

systems(F) 

rmail(ADM) 

uuencode(C) 

uuencode(C) 

uugetty(ADM) 

uuinstall(ADM) 

uulist(ADM) 

uulist(ADM) 

uuto(C) 

uusched(ADM) 

uustat(C) 

uusub(C) 

uuto(C) 

uutry(ADM) 

uux(C) 

val(CP) 

val(CP) 

assert(S) 

abs(S) 

floor(S) 

getenv(S) 

labs(DOS) 

idtune(ADM) 

putenv(S) 

true(C) 

false(C) 

machid(C) 

values(M) 

sysdef(ADM) 

values(M) 

varargs(S) 

varargs(S) 

tz(M) 

edit(C) 
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vc: version control.vc(C) 

Gets option letter from argument vector, getopt: .getopt(S) 

the/ /displays the list of vectors currently specified in . . . vectorsinuse(ADM) 

of vectors currently specified/ vectorsinuse: displays the list . . vectorsinuse(ADM) 

display editor, vi, view, vedit: Invokes a screen-oriented . vi(C) 

assert: Helps verify validity of program.assert(S) 

vc: version control .vc(C) 

red: Invokes a restricted version of. .red(C) 

sccsdiffi Compares two versions of an SCCS file.sccsdifl(CP) 

formatted output of a/ vprintf, vfprintf, vsprintf: Prints.vprintf(S) 

screen-oriented display editor, vi, view, vedit: Invokes a .... vi(C) 

a binary file for transmission via mail uudecode: decode . . . uuencode(C) 

a binary file for transmission via mail uuencode: encode . . . uuencode(C) 

submit remote mail received via UUCP rmail: .rmail(ADM) 

the font and video mode for a video device, vidi: Sets.vidi(C) 

vidi: Sets the font and video mode for a video device. . . vidi(C) 
mode for a video device, vidi: Sets the font and video . . . vidi(C) 

screen-oriented display/ vi, view, vedit: Invokes a .vi(C) 

vmstat. Reports virtual memory statistics.vmstat(C) 

statistics, vmstat: Reports virtual memory . . vmstat(C) 

UNIX file system volcopy: make literal copy of . . . volcopy(ADM) 

file system: Format of a system volume.filesystem(F) 

Prints formatted output of a/ vprintf, vfprintf, vsprintf: .... vprintf(S) 

output of a/ vprintf, vfprintf, vsprintf: Prints formatted .... vprintf(S) 
who is on the system and what w: Displays information about . . w(C) 

background processes, wait: Awaits completion of ... wait(C) 

event. ev_block: Wait until the queue contains an . ev_block(S) 

to stop or terminate, wait: Waits for a child process . . wait(S) ^ 

sigsem: Signals a process waiting on a semaphore.sigsem(S) 

stop or terminate, wait: Waits for a child process to ... wait(S) 
checks access to a resource/ waitsem, nbwaitsem: Awaits and . waitsem(S) 

ftw: Walks a file tree.ftw(S) 

wall: Writes to all users.wall(ADM) 

characters, wc: Counts lines, words and . . . wc(C) 

whodo: Determines who is doing what.whodo(C) 

what, whodo: Determines who is doing . whodo(C) 

jagent: host control of windowing terminal .jagent(M) 

jterm: reset layer of windowing terminal .jterm(C) 

ismpx: return windowing terminal state .... ismpx(C) 

/protocol used between host and windowing terminal under .... layers(M) 

layers: layer multiplexer for windowing terminals.layers(C) 

multiplexed tty driver for AT&T windowing terminals xt: .... xt(HW) 

cd: Changes working directory.cd(C) 

chdir: Changes the working directory.chdir(S) 

pwd: Prints working directory name.pwd(C) 

Get the pathname of current working directory, getcwd: . . . getcwd(S) 

Scan the spool directory for work, uucico:.uucico(C) 

fputc, fputchar: Write a character to a stream. . . . fputc(DOS) ^ 

write: Writes to a file.write(S) 

write: Writes to another user. . . . write(C) 

outp: Writes a byte to an output port. . . outp(DOS) 
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console, putch: Writes a character to the.putch(DOS) 

putpwent: Writes a password file entry. . . . putpwent(S) 

write: Writes to a file.write(S) 

wall: Writes to all users.wall(ADM) 

write: Writes to another user.write(C) 

open: Opens file for reading or writing.open(S) 

a file region for reading or writing. /Locks or unlocks .... locking(S) 

a file for shared reading and writing, sopen: Opens .sopen(DOS) 

the 5620 DMD terminal wtinit: object downloader for ... wtinit(ADM) 

utmp, wtmp: Formats of utmp and wtmp entries.utmp(F) 

entries, utmp, wtmp: Formats of utmp and wtmp . utmp(F) 
accounting/ fwtmp: fwtmp, wtmpfix: manipulate connect . . . fwtmp(ADM) 

x286emul: emulate XENIX 80286 . x286emul(C) 
commands, xargs: Constructs and executes . . xargs(C) 
incremental filesystem backup, xbackup: Performs XENIX .... xbackup(ADM) 

x286emul: emulate XENIX 80286 x286emul(C) 

Assembler, asx: XENIX 8086/186/286/386 .... asx(CP) 

masm: Invokes the XENIX assembler.masm(CP) 

boot: XENIX boot program.boot(HW) 

intro: Introduces XENIX commands.Intro(C) 

commands, intro: Introduces XENIX Development System . . Intro(CP) 

Convert 386 COFF files to XENIX format, coffconv: .... coffconv(M) 
xinstall: XENIX installation shell script . . xinstall(ADM) 

netutil: Administers the XENIX network.netutil(ADM) 

config: Configures a XENIX system.config(ADM) 

cu: Calls another XENIX system.cu(C) 

uname: Gets name of current XENIX system.uname(S) 

Executes commands on a remote XENIX system, remote: .... remote(C) 

rep: Copies files across XENIX systems.rcp(C) 

Prints the name of the current XENIX system, uname:.uname(C) 

dosld: XENIX to MS-DOS cross linker. . dosld(CP) 

uux: Executes command on remote XENIX.uux(C) 

mmdfalias: converts XENIX-style aliases file to/ . . . mmdfalias(ADM) 

to/ mnlist: converts a XENIX-style Micnet routing file . mnlist(ADM) 

file to/ uulist: converts a XENIX-style UUCP routing . . . uulist(ADM) 

uuto, uupick: Public XENDC-to-XENIX file copy. . . . uuto(C) 

shell script xinstall: XENIX installation . . . xinstall(ADM) 

entries from files, xlist, fxlist: Gets name list .... xlist(S) 

programs, xref: Cross-references C.xref(CP) 

incremental file system/ xrestore: Invokes XENIX .... xrestore(ADM) 
programs, xstr: Extracts strings from C ... xstr(CP) 

xtt: extract and print xt driver packet traces .xtt(ADM) 

xts: extract and print xt driver statistics .xts(ADM) 

AT&T windowing terminals xt: multiplexed tty driver for . . . xt(HW) 
channels protocol used by xt(7) driver /multiplexed .... xtproto(M) 

protocol used by x t (7)/ xtproto: multiplexed channels . . xtproto(M) 

statistics xts: extract and print xt driver . . xts(ADM) 

packet traces xtt: extract and print xt driver . . xtt(ADM) 

functions, bessel, jO, jl, jn, y0,yl, yn: Performs Bessel . . . bessel(S) 

bessel, jO, jl,jn,y0, yl,yn: Performs Bessel/.bessel(S) 

compiler-compiler, yacc: Invokes a .yacc(CP) 
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yes: Prints string repeatedly. . . . yes(C) 

bessel, jO, jl, jn, yO, yl, yn: Performs Bessel functions. . . bessel(S) 

zcat: Display a stored file.compress(C) 

true: Returns with a zero exit value.true(C) 

TZ: Time zone environment variable. . . . tz(M) 

set default system time zone timezone: .timezone(F) 
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